Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.usekinetic.com/llms.txt

Use this file to discover all available pages before exploring further.

Get Submissions

GET /api/v1/external/forms/:formId/submissions
GET /api/v1/external/submissions
The first endpoint returns submissions for a specific form. The second returns submissions across all forms.

Parameters

ParameterTypeDefaultDescription
emailstringFilter by email (supports * wildcard, e.g. *@gmail.com)
sinceISO 8601Submissions after this timestamp
untilISO 8601Submissions before this timestamp
partialbooleanfalseInclude partial (incomplete) submissions
limitinteger50Results per page (max 200)
offsetinteger0Skip this many results
sortstringcreated_atSort field
orderstringdescSort direction (asc/desc)
form_idUUIDFilter by form (cross-form endpoint only)

Response

{
  "data": [
    {
      "id": "bfe0dd18-...",
      "created_at": "2026-05-15T09:32:16Z",
      "email": "user@example.com",
      "answers": { "field_name": "value" },
      "partial_submission": false,
      "completion_time_seconds": 84,
      "embed_domain": "store.example.com",
      "embed_mode": "popup"
    }
  ],
  "pagination": { "total": 796, "limit": 50, "offset": 0 }
}

Incremental sync example

Fetch new submissions every 5 minutes:
curl -H "Authorization: Bearer kntc_..." \
  "https://app.usekinetic.com/api/v1/external/submissions?since=2026-05-16T10:30:00Z"