> ## 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.

# Fetching submissions

> Returns a specific form submission with all its responses and the form questions.



## OpenAPI

````yaml GET /forms/{formId}/submissions/{submissionId}
openapi: 3.0.1
info:
  title: OpenAPI
  description: Tally's API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.tally.so
security:
  - bearerAuth: []
paths:
  /forms/{formId}/submissions/{submissionId}:
    get:
      tags:
        - Forms
      summary: Retrieve a form submission
      description: >-
        Returns a specific form submission with all its responses and the form
        questions.
      parameters:
        - name: formId
          in: path
          required: true
          description: The ID of the form
          schema:
            type: string
        - name: submissionId
          in: path
          required: true
          description: The ID of the submission to retrieve
          schema:
            type: string
      responses:
        '200':
          description: Form submission retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  questions:
                    type: array
                    description: List of form questions with their fields
                    items:
                      $ref: '#/components/schemas/Question'
                  submission:
                    type: object
                    description: The form submission with responses
                    properties:
                      id:
                        type: string
                        description: Submission ID
                      formId:
                        type: string
                        description: Form ID
                      isCompleted:
                        type: boolean
                        description: Whether the submission is completed
                      submittedAt:
                        type: string
                        format: date-time
                        description: When the submission was submitted
                      createdAt:
                        type: string
                        format: date-time
                        description: When the submission was created
                      updatedAt:
                        type: string
                        format: date-time
                        description: When the submission was last updated
                      previewUrl:
                        type: string
                        format: uri
                        description: >-
                          Signed URL to view the submission in a browser.
                          Includes an access token, no expiry.
                      pdfUrl:
                        type: string
                        format: uri
                        description: >-
                          Signed URL to download the submission as a PDF.
                          Includes an access token, no expiry.
                      responses:
                        type: array
                        description: >-
                          List of responses to form questions. Note: Only
                          questions that have been answered will appear in this
                          array.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Response ID
                            formId:
                              type: string
                              description: Form ID
                            questionId:
                              type: string
                              description: Question ID
                            respondentId:
                              type: string
                              description: Respondent ID
                            submissionId:
                              type: string
                              nullable: true
                              description: Submission ID
                            sessionUuid:
                              type: string
                              format: uuid
                              description: Session UUID
                            answer:
                              description: >-
                                The answer value for this question. Type varies
                                based on question type.
                              nullable: true
                              oneOf:
                                - type: string
                                - type: number
                                - type: boolean
                                - type: array
                                  items: {}
                                - type: object
                            formattedAnswer:
                              type: string
                              description: >-
                                Formatted answer (e.g., for number inputs with
                                custom formatting)
                            createdAt:
                              type: string
                              format: date-time
                              description: When the response was created
                            updatedAt:
                              type: string
                              format: date-time
                              description: When the response was last updated
                          required:
                            - id
                            - formId
                            - questionId
                            - respondentId
                            - sessionUuid
                            - answer
                            - createdAt
                            - updatedAt
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Form or submission not found
      security:
        - bearerAuth: []
components:
  schemas:
    Question:
      type: object
      properties:
        id:
          type: string
        type:
          $ref: '#/components/schemas/BlockType'
        title:
          type: string
        isTitleModifiedByUser:
          type: boolean
        formId:
          type: string
        isDeleted:
          type: boolean
        numberOfResponses:
          type: integer
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        fields:
          type: array
          items:
            $ref: '#/components/schemas/QuestionField'
    BlockType:
      type: string
      enum:
        - FORM_TITLE
        - TEXT
        - LABEL
        - TITLE
        - HEADING_1
        - HEADING_2
        - HEADING_3
        - DIVIDER
        - PAGE_BREAK
        - IMAGE
        - EMBED
        - EMBED_VIDEO
        - EMBED_AUDIO
        - QUESTION
        - MATRIX
        - INPUT_TEXT
        - INPUT_NUMBER
        - INPUT_EMAIL
        - INPUT_LINK
        - INPUT_PHONE_NUMBER
        - INPUT_DATE
        - INPUT_TIME
        - TEXTAREA
        - FILE_UPLOAD
        - LINEAR_SCALE
        - RATING
        - HIDDEN_FIELDS
        - MULTIPLE_CHOICE_OPTION
        - CHECKBOX
        - DROPDOWN_OPTION
        - RANKING_OPTION
        - MULTI_SELECT_OPTION
        - PAYMENT
        - SIGNATURE
        - MATRIX_ROW
        - MATRIX_COLUMN
        - WALLET_CONNECT
        - CONDITIONAL_LOGIC
        - CALCULATED_FIELDS
        - CAPTCHA
        - RESPONDENT_COUNTRY
    QuestionField:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        type:
          $ref: '#/components/schemas/BlockType'
        blockGroupUuid:
          type: string
          format: uuid
        title:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````