API Reference

Retrieve form submissions programmatically using the FormBold REST API. This API allows you to integrate your form data into your own systems, build custom dashboards, or automate internal workflows.

Authentication Required: All API requests require a Personal Access Token. You can generate and manage your tokens from the Account Settings -> API Tokens section in your FormBold dashboard.

Enable API Access: To use the API for a specific form, you must enable the HTTP API Access toggle within that form’s Settings tab in the dashboard.

Authentication

All API requests must include your token in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_API_TOKEN

List Submissions API

Retrieve, search, and paginate through all submissions for a specific form.

Endpoint

GET https://api.formbold.com/api/forms/{formId}/submissions

Parameters

Request Example

  curl -X GET "https://api.formbold.com/api/forms/YOUR_FORM_ID/submissions?page=1&limit=10" \
       -H "Authorization: Bearer YOUR_API_TOKEN"

  const response = await fetch('https://api.formbold.com/api/forms/YOUR_FORM_ID/submissions', {
    headers: {
      'Authorization': 'Bearer YOUR_API_TOKEN'
    }
  });
  const data = await response.json();
  console.log(data);

  import requests
  url = "https://api.formbold.com/api/forms/YOUR_FORM_ID/submissions"
  headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
  response = requests.get(url, headers=headers)
  print(response.json())

Success Response (200)

{
  "data": [
    {
      "id": 123,
      "data": {
        "name": "John Doe",
        "email": "john@example.com",
        "message": "Hello!"
      },
      "created_at": "2024-05-11T10:30:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "total": 150,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 15,
      "links": {
        "previous": null,
        "next": "https://api.formbold.com/api/forms/YOUR_FORM_ID/submissions?page=2"
      }
    }
  }
}

Error Responses