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>"
        }
      ]
    }
  ]
}

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
​
submissionId
string

Get a specific submission by ID

Response

200
application/json
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

Delete a formDelete a form submission