---
title: "List form submissions"
method: GET
path: "/forms/{formId}/submissions"
tags: ["Forms"]
---

# List form submissions

`GET /forms/{formId}/submissions`

Returns a paginated list of form submissions with their responses.

## Path parameters

- `formId` string, required

## Query parameters

- `page` number
- `filter` 'all' | 'completed' | 'partial'
- `startDate` string, date-time
- `endDate` string, date-time
- `afterId` string
- `limit` number

## Response `200`

List of form submissions

- object
  - `page` number — Current page number
  - `limit` number — Number of submissions per page
  - `hasMore` boolean — Whether there are more pages available
  - `totalNumberOfSubmissionsPerFilter` object
    - `all` number — Total number of all submissions
    - `completed` number — Total number of completed submissions
    - `partial` number — Total number of partial submissions
  - `questions` Question[] — List of form questions
    - `id` string
    - `type` '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' | 'CONDITIONAL_LOGIC' | 'CALCULATED_FIELDS' | 'CAPTCHA' | 'RESPONDENT_COUNTRY'
    - `title` string
    - `isTitleModifiedByUser` boolean
    - `formId` string
    - `isDeleted` boolean
    - `numberOfResponses` integer
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `fields` QuestionField[]
      - `uuid` string, uuid
      - `type` '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' | 'CONDITIONAL_LOGIC' | 'CALCULATED_FIELDS' | 'CAPTCHA' | 'RESPONDENT_COUNTRY'
      - `blockGroupUuid` string, uuid
      - `title` string
  - `submissions` object[] — List of form submissions
    - `id` string — Submission ID
    - `formId` string — Form ID
    - `isCompleted` boolean — Whether the submission is completed
    - `submittedAt` string, date-time — When the submission was submitted
    - `previewUrl` string, uri — Signed URL to view the submission in a browser. Includes an access token, no expiry.
    - `pdfUrl` string, uri — Signed URL to download the submission as a PDF. Includes an access token, no expiry.
    - `responses` object[] — List of responses to form questions. Note: Only questions that have been answered will appear in this array.
      - `id` string, required — Response ID
      - `formId` string, required — Form ID
      - `questionId` string, required — Question ID
      - `respondentId` string, required — Respondent ID
      - `submissionId` string, nullable — Submission ID
      - `sessionUuid` string, uuid, required — Session UUID
      - `answer` union, required — The answer value for this question. Type varies based on question type.
        - string
        - number
        - boolean
        - unknown[]
          - unknown
        - object
      - `formattedAnswer` string — Formatted answer (e.g., for number inputs with custom formatting)
      - `createdAt` string, date-time, required — When the response was created
      - `updatedAt` string, date-time, required — When the response was last updated

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Form not found

---

[API](https://skmtc.net/tally/apis/openapi.md) · [All operations](https://skmtc.net/tally/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tally/openapi/revisions/3ae813325ad6/schema)