Skip to main content
Retrieve and manage form submissions. Each submission contains the user’s responses and metadata.

​
Endpoints

MethodEndpointDescription
GET/v1/forms/{form_id}/submissionsList submissions for a form

​
Query Parameters

ParameterTypeDescription
pageintegerPage number (default: 1)
per_pageintegerResults per page (default: 20, max: 100)
sincestringFilter submissions after this ISO 8601 date
untilstringFilter submissions before this ISO 8601 date
statusstringFilter by status: completed or partial

​
Example Response

GET /v1/forms/{form_id}/submissions 
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "fields": {
        "email": "[email protected]",
        "message": "Hello, I have a question..."
      },
      "status": "completed",
      "submitted_at": "2024-01-15T14:30:00Z",
      "metadata": {
        "referrer": "https://example.com",
        "user_agent": "Mozilla/5.0...",
        "device_type": "desktop",
        "utm_source": "google",
        "utm_medium": "cpc",
        "utm_campaign": "spring_sale"
      }
    }
  ],
  "meta": {
    "total": 150,
    "page": 1,
    "per_page": 20,
    "total_pages": 8
  }
}
Next: Scheduling API