# List form submissions

**Publié le** : 2026-05-08
**Catégorie** : Forms & Reviews

## `GET /forms/:id/submissions`

**List form submissions**

Returns paginated submissions for a form. Supports filtering by
status (unread, read, archived, spam) and date range.

Required permissions: `forms.submissions.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |
| `page` | query | number | No | Number |
| `limit` | query | number | No | Number <= 100 |
| `status` | query | "new" \| "read" \| "spam" \| "archived" | No | One of: new, read, spam, archived |
| `search` | query | string | No | Full-text search query |
| `sortBy` | query | "created_at" \| "updated_at" \| "status" | No | One of: created_at, updated_at, status |
| `sortOrder` | query | "asc" \| "desc" | No | One of: asc, desc |
| `dateFrom` | query | string | No | Filter from date (ISO 8601) |
| `dateTo` | query | string | No | Filter until date (ISO 8601) |
| `ids` | query | string[] | No | Array of strings |
| `excludeIds` | query | string[] | No | Array of strings |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |
| `404` | Not found |


### Examples

```bash
curl "https://api.lynkow.com/v1/forms/1/submissions?status=unread&page=1" \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": [
    {
      "id": 501,
      "formId": 1,
      "status": "unread",
      "data": {
        "name": "Sophie Bernard",
        "email": "sophie@example.com",
        "message": "I would like to know more about your enterprise plan."
      },
      "ipAddress": "203.0.113.42",
      "userAgent": "Mozilla/5.0",
      "createdAt": "2025-04-05T16:30:00.000Z"
    },
    {
      "id": 500,
      "formId": 1,
      "status": "read",
      "data": {
        "name": "Marc Leroy",
        "email": "marc@example.com",
        "message": "Can I schedule a demo?"
      },
      "ipAddress": "198.51.100.17",
      "userAgent": "Mozilla/5.0",
      "createdAt": "2025-04-04T10:15:00.000Z"
    }
  ],
  "meta": {
    "total": 134,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 9
  }
}
```

---