---
title: "GET /api/public/forms/{formId}/responses"
method: GET
path: "/api/public/forms/{formId}/responses"
tags: ["Forms"]
---

# GET /api/public/forms/{formId}/responses

`GET /api/public/forms/{formId}/responses`

List submitted responses for a form, newest first. Trainee personal details and phone number are included only when the key also has trainees:read; coach private notes are never returned.

## Path parameters

- `formId` string, required

## Query parameters

- `traineeId` string
- `status` 'Pending' | 'Handled'
- `search` string
- `dateFrom` string
- `dateTo` string
- `page` integer
- `limit` integer

## Response `200`

Successful response

- object — Successful response
  - `data` object[]
    - `id` string
    - `form` object — The form this response belongs to.
      - `id` string
      - `title` string
      - `type` string
    - `trainee` object — The trainee who submitted the response.
      - `id` string
      - `fullName` string
    - `responses` object[] — The submitted answers, one entry per form field.
      - `field` string — Field id from the form definition.
      - `label` string — Field label shown to the trainee.
      - `fieldType` string — Field type, e.g. text, number, file.
    - `status` 'Pending' | 'Handled' — Whether the coach has handled this response.
    - `type` 'update' | 'registration' — Whether this is a periodic update or a registration submission.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `pagination` object
    - `page` number
    - `limit` number
    - `total` number, nullable — Total number of matching items. null when the underlying source cannot report an exact count for this page; use hasMore to keep paging.
    - `hasMore` boolean
    - `truncated` boolean — Present and true when the result set exceeded the in-memory scan cap and was truncated. Narrow your filters to page through all items.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `429` — Default Response
- `500` — Default Response

---

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