---
title: "List Submissions"
method: GET
path: "/open/forms/{id}/submissions"
tags: ["Submissions"]
---

# List Submissions

`GET /open/forms/{id}/submissions`

Requires `forms-read`. Supports pagination, search, and status filtering.

## Path parameters

- `id` number, required

## Query parameters

- `page` number
- `per_page` number
- `search` string
- `status` 'completed' | 'partial' | 'all'

## Response `200`

Successful

- object
  - `data` Submission[]
    - `id` number — Unique submission ID
    - `form_id` number — ID of the parent form
    - `completion_time` number, nullable — Time taken to complete the form in seconds
    - `data` object — Contains form field responses plus metadata (status, created_at, id)
  - `links` object
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` object
    - `current_page` number
    - `from` number
    - `last_page` number
    - `per_page` number
    - `to` number
    - `total` number

## Other responses

- `403` — Forbidden – token lacks forms-read ability

---

[API](https://skmtc.dev/opnform/apis/opnform-api.md) · [All operations](https://skmtc.dev/opnform/apis/opnform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opnform/opnform-api/revisions/271b61a0082b/schema)