# List campaigns

### List campaigns

`GET /api/v1/campaigns`

Operation ID: `listCampaigns`

**Query parameters**

- `cursor` (string, optional)
- `limit` (integer, optional)
- `status` ("draft" | "active" | "paused" | "completed" | "archived", optional)

**200**: A page of campaigns, newest first. Pass nextCursor as cursor for the next page.

- `campaigns` (object[], required)
- `nextCursor` (string | null, required)

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload