GET
/
forms
/
{formId}
/
submissions
List form 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<date-time>

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

endDate
string<date-time>

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

afterId
string

Get submissions that came after a specific submission ID

Response

List of form submissions

page
number

Current page number

limit
number

Number of submissions per page

hasMore
boolean

Whether there are more pages available

totalNumberOfSubmissionsPerFilter
object
questions
object[]

List of form questions

submissions
object[]

List of form submissions