# List campaigns (/api-reference/campaigns/listCampaigns)

## List campaigns

`GET https://app.alienmail.io/api/v1/campaigns`

The campaigns of your workspace, newest first. Archived campaigns are included; deleted ones are not.

Requires the `CAMPAIGN_READ` permission.

Authentication: `Authorization: Bearer <your API key>`

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `status` | query | "draft" \| "active" \| "paused" \| "completed" \| "archived" | no | Only campaigns with this status. |
| `search` | query | string | no | Only campaigns whose name contains this text. |
| `limit` | query | integer | no | Items per page, 1 to 100. Default 25. A number outside that range is rounded to the nearest limit (`0` is 1, `500` is 100) and a fraction rounded down; anything that is not a number is the default. |
| `cursor` | query | string | no | The `nextCursor` of the previous page. Anything else returns 400. |

### Responses

**200**: A page of campaigns.

```json
{
  "data": [
    {
      "id": 42,
      "name": "Q1 outreach",
      "status": "active",
      "leadCount": 180,
      "sentCount": 412,
      "lastSentAt": "2026-11-13T09:30:00.000Z",
      "createdAt": "2026-11-13T09:30:00.000Z",
      "updatedAt": "2026-11-13T09:30:00.000Z"
    }
  ],
  "nextCursor": null
}
```

**400**: The request is invalid: `fields` names the parameters to fix.

**401**: The API key is missing, wrong or revoked, its creator left the workspace or was suspended, or the workspace is archived or deleted.

**403**: The API key's role lacks the permission this endpoint needs.

**429**: More than 120 requests in a minute with this key, or a workspace limit on adding and removing leads.

Errors look like `{ "error": { "code": "not_found", "message": "Campaign not found" } }`. See the Errors page.