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

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.