> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Form Submissions

> Retrieves a list of submissions for a specific form.

import { ParamField } from "/snippets/param-field.mdx";
import { ResponseField } from "/snippets/response-field.mdx";

### GET /v1/forms/:id/submissions

Retrieves a paginated list of submissions for a specific form.

#### Path Parameters

<ParamField name="id" type="string" required>
  The ID of the form to retrieve submissions for.
</ParamField>

#### Query Parameters

<ParamField name="fromDate" type="string">
  The start date for filtering submissions, in ISO 8601 format.
</ParamField>

<ParamField name="toDate" type="string">
  The end date for filtering submissions, in ISO 8601 format.
</ParamField>

<ParamField name="limit" type="integer">
  The maximum number of submissions to return. Defaults to `20`.
</ParamField>

<ParamField name="offset" type="integer">
  The number of submissions to skip before starting to collect the result set.
</ParamField>

### The Submission object

<ResponseField name="id" type="string" required>
  The unique identifier for the submission.
</ResponseField>

<ResponseField name="form_id" type="string" required>
  The ID of the form this submission belongs to.
</ResponseField>

<ResponseField name="data" type="object" required>
  An object containing the submitted form data.
</ResponseField>

<ResponseField name="metadata" type="object">
  An object containing metadata about the submission, such as IP address and user agent.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  The date and time the submission was created, in ISO 8601 format.
</ResponseField>

#### Example Request

```bash theme={null}
curl -X GET "https://api.example.com/v1/forms/form_123/submissions" \
     -H "Authorization: Bearer <YOUR_API_KEY>"
```

#### Example Response

```json theme={null}
{
  "items": [
    {
      "id": "sub_789",
      "form_id": "form_123",
      "data": {
        "name": "John Doe",
        "email": "john.doe@example.com"
      },
      "metadata": {
        "ipAddress": "127.0.0.1",
        "userAgent": "curl/7.81.0"
      },
      "created_at": "2023-01-03T00:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}
```