Skip to main content
GET
/
forms
/
{formId}
/
submissions
/
{submissionId}
Retrieve a form submission
curl --request GET \
  --url https://api.tally.so/forms/{formId}/submissions/{submissionId} \
  --header 'Authorization: Bearer <token>'
{
  "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>"
        }
      ]
    }
  ],
  "submission": {
    "id": "<string>",
    "formId": "<string>",
    "isCompleted": true,
    "submittedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "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

​
submissionId
string
required

The ID of the submission to retrieve

Response

Form submission retrieved successfully

​
questions
object[]

List of form questions with their fields

​
submission
object

The form submission with responses