GET
/
forms
/
{formId}
/
submissions
curl --request GET \
  --url https://api.tally.so/forms/{formId}/submissions \
  --header 'Authorization: Bearer <token>'
{
  "page": 123,
  "limit": 123,
  "hasMore": true,
  "totalNumberOfSubmissionsPerFilter": {
    "all": 123,
    "completed": 123,
    "partial": 123
  },
  "questions": [
    {
      "id": "<string>",
      "type": "FORM_TITLE",
      "title": "<string>",
      "isTitleModifiedByUser": true,
      "formId": "<string>",
      "isDeleted": true,
      "numberOfResponses": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "fields": [
        {
          "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "type": "FORM_TITLE",
          "blockGroupUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "title": "<string>"
        }
      ]
    }
  ],
  "submissions": [
    {
      "id": "<string>",
      "formId": "<string>",
      "isCompleted": true,
      "submittedAt": "2023-11-07T05:31:56Z",
      "responses": [
        {
          "questionId": "<string>",
          "value": "<string>"
        }
      ]
    }
  ]
}

Looking for real-time submissions? The most efficient way to instantly retrieve new submissions is by using a webhook. This allows you to receive data as soon as a form is submitted, without needing to poll the API.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

formId
string
required

The ID of the form

Query Parameters

page
number

Page number for pagination (default: 1)

filter
enum<string>

Filter submissions by status

Available options:
all,
completed,
partial
startDate
string

Filter submissions submitted on or after this date (ISO 8601 format)

endDate
string

Filter submissions submitted on or before this date (ISO 8601 format)

afterId
string

Get submissions that came after a specific submission ID

Response

200
application/json

List of form submissions

The response is of type object.