---
title: "List Form Responses"
method: GET
path: "/v1/forms/{id}/form-responses"
---

# List Form Responses

`GET /v1/forms/{id}/form-responses`

This API endpoint retrieves all the responses (Pending & Completed) to a given form.

## Path parameters

- `id` string, required

## Query parameters

- `nextToken` string
- `limit` integer
- `status` string

## Response `200`

200

- object
  - `data` object[]
    - `allowMultipleSubmissions` boolean
    - `clientId` string
    - `createdAt` string
    - `formDescription` string
    - `formFieldIds` string[]
    - `formFields` object
      - `09c8dc93-4532-4995-831e-4bdf1c2e437b` object
        - `title` string
        - `description` string
        - `type` string
        - `multipleChoiceOptions` string[]
        - `isRequired` boolean
        - `answer` string[]
      - `2b7e3a5a-f335-430a-a8e9-8259c9f971d1` object
        - `title` string
        - `description` string
        - `type` string
        - `multipleChoiceOptions` string[]
        - `isRequired` boolean
        - `answer` string[]
      - `425fa7b8-4446-4864-8542-d9a1bdd61991` object
        - `title` string
        - `description` string
        - `type` string
        - `isRequired` boolean
      - `47741982-6b81-4041-8063-d8f825259318` object
        - `title` string
        - `description` string
        - `type` string
        - `isRequired` boolean
        - `answer` string
      - `7399360f-39f3-415f-af53-e223476b58eb` object
        - `title` string
        - `description` string
        - `type` string
        - `isRequired` boolean
        - `answer` string[]
        - `attachmentUrls` string[]
      - `a9da9a50-4196-4bc6-b6a3-345f33add0ef` object
        - `title` string
        - `description` string
        - `type` string
        - `isRequired` boolean
        - `answer` string
    - `formId` string
    - `formName` string
    - `id` string
    - `object` string
    - `status` string
    - `submissionDate` string
    - `visibility` string
    - `updatedAt` string
  - `nextToken` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/assembly/apis/core-resources.md) · [All operations](https://skmtc.dev/assembly/apis/core-resources/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/assembly/core-resources/revisions/28a9e7d13a8c/schema)