---
title: "List form submissions"
method: GET
path: "/forms/{form_id}/submissions"
---

# List form submissions

`GET /forms/{form_id}/submissions`

## Request

- Base URL: `https://app.formasty.com/api/v1`
- URL: `https://app.formasty.com/api/v1/forms/{form_id}/submissions`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://app.formasty.com/oauth/authorize/api/v1`, token URL `https://app.formasty.com/oauth/token`)
  - HTTP bearer

Lists completed submissions for one published form.

## Path parameters

- `form_id` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `after` string, date-time

## Response `200`

Submission records.

- SubmissionListResponse
  - `data` SubmissionRecord[], required
    - `event` string, required
    - `eventId` string, required
    - `form` object, required
      - `id` string, required
      - `publicId` string, required
      - `name` string, required
      - `workspaceId` string, required
      - `publishedAt` string, nullable
      - `version` integer, required
    - `submission` object, required
      - `id` string, required
      - `createdAt` string, required
    - `answers` object, required
    - `fields` object[], required
      - `id` string, required
      - `label` string, required
      - `value` unknown, required
    - `meta` object, required
    - `answersByFieldId` object, required
  - `next_cursor` string, nullable, required: Opaque continuation token. Pass it as cursor with the same form and after filter; null means the collection is exhausted.

## Other responses

- `default`: A machine-readable error with a stable code and a recovery hint. The legacy error value is retained for existing clients.

---

[API](https://skmtc.dev/formasty/apis/formasty-forms-api.md) · [All operations](https://skmtc.dev/formasty/apis/formasty-forms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/formasty/apis/formasty-forms-api/revisions/09ad7f50c693?raw)