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>",
      "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",
          "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",
    "previewUrl": "<string>",
    "pdfUrl": "<string>",
    "responses": [
      {
        "id": "<string>",
        "formId": "<string>",
        "questionId": "<string>",
        "respondentId": "<string>",
        "sessionUuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "answer": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "submissionId": "<string>",
        "formattedAnswer": "<string>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.tally.so/llms.txt

Use this file to discover all available pages before exploring further.

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