List form submissions
Read answers and respondent contact details, most recently started first. To sync responses, set updatedAfter, sort by updatedAt ascending, and pass nextCursor as cursor until hasMore is false. Use submittedAfter to filter submitted responses. documentId links to the ordinary document API, which separately enforces document access.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
2026-09, 2026-10 ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Path Parameters
The form ID.
Query Parameters
Maximum number of items to return, from 1 to 100. Default: 25.
1 <= x <= 100The nextCursor from the previous response, to get the next page. Keep the other parameters unchanged.
1 - 2048total adds the number of items that match the filters. Counting takes time, so ask for it only when you need it.
total Returns only submissions with one of these statuses. Comma-separated or repeated.
STARTED, SUBMITTED, COMPLETED, EXPIRED Only submissions submitted at or after this ISO 8601 date or date-time.
Only submissions submitted at or before this ISO 8601 date or date-time.
Only submissions updated at or after this ISO 8601 date or date-time. Use it for incremental sync.
Only submissions updated at or before this ISO 8601 date or date-time.
The field to sort by. Default: startedAt.
startedAt, updatedAt The sort direction. Default: desc.
asc, desc Response
200
True if more items follow this page.
Pass this as cursor to get the next page. Null on the last page.
The number of items that match the filters. Present only with include=total.
-9007199254740991 <= x <= 9007199254740991
