Form submissions

List form submissions

Lists submissions, most-recent-first, paginated, with filters.

GET
/form-submissions

Lists submissions, most-recent-first, paginated, with filters.

Authorization

x-api-key<token>

The per-tenant API key, copied from Settings → API & integrations. Sent as the x-api-key request header. The key is tenant-scoped and acts with Admin-equivalent, tenant-wide access.

In: header

Query Parameters

limit?integer

Page size, 1–200. Defaults to 50.

cursor?string

Opaque cursor from a previous page's nextCursor. Omit for the first page.

templateId?string

Filter by template id.

projectId?array<>

Filter by project id (repeatable).

submitterId?array<>

Filter by submitter user id (repeatable).

from?string

Inclusive start of the submitted-at date range (YYYY-MM-DD).

to?string

Inclusive end of the submitted-at date range (YYYY-MM-DD).

search?string

Free-text match on submitter/template name and text answers.

Response Body

application/json

application/json

curl -X GET "https://example.com/form-submissions"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",      "templateName": "string",      "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",      "projectName": "string",      "projectArchived": true,      "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",      "submitterName": "string",      "submittedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}
{  "error": {    "code": "unauthorized",    "message": "Missing or invalid API key."  }}