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

# Submissions API

> Retrieve and manage form submissions. Each submission contains the user's responses and metadata.

Retrieve and manage form submissions. Each submission contains the user's responses and metadata.

## Endpoints

| Method | Endpoint                          | Description                 |
| ------ | --------------------------------- | --------------------------- |
| `GET`  | `/v1/forms/{form_id}/submissions` | List submissions for a form |

## Query Parameters

| Parameter  | Type    | Description                                  |
| ---------- | ------- | -------------------------------------------- |
| `page`     | integer | Page number (default: 1)                     |
| `per_page` | integer | Results per page (default: 20, max: 100)     |
| `since`    | string  | Filter submissions after this ISO 8601 date  |
| `until`    | string  | Filter submissions before this ISO 8601 date |
| `status`   | string  | Filter by status: completed or partial       |

## Example Response

`GET /v1/forms/{form_id}/submissions`

```json theme={null}
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "fields": {
        "email": "user@example.com",
        "message": "Hello, I have a question..."
      },
      "status": "completed",
      "submitted_at": "2024-01-15T14:30:00Z",
      "metadata": {
        "referrer": "https://example.com",
        "user_agent": "Mozilla/5.0...",
        "device_type": "desktop",
        "utm_source": "google",
        "utm_medium": "cpc",
        "utm_campaign": "spring_sale"
      }
    }
  ],
  "meta": {
    "total": 150,
    "page": 1,
    "per_page": 20,
    "total_pages": 8
  }
}
```

[Next: Scheduling API](/developers/api/scheduling)