# GET /email-campaigns

**Resource:** [Email Campaigns](./email-campaigns.md)  
**Scopes:** `email-campaigns:read`  
**Write operation:** no

List all email campaigns for the company. Filter by status.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `status` | query | string | no | Filter by status: draft, scheduled, sending, sent, failed |
| `limit` | query | number | no | Max results (1-100) |
| `after` | query | string | no | Cursor for pagination |

## Request example

```bash
curl -X GET \
  "https://api.trustpager.com/functions/v1/api/v1/email-campaigns?status=sent&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response example

```json
{
  "data": [
    {
      "id": "campaign-uuid-...",
      "name": "April Newsletter",
      "status": "sent",
      "subject": "What's new this April",
      "recipient_count": 124,
      "sent_count": 124,
      "delivered_count": 121,
      "opened_count": 58,
      "clicked_count": 23,
      "bounced_count": 3,
      "unsubscribed_count": 1,
      "sent_at": "2026-04-01T09:00:00Z",
      "created_at": "2026-03-28T14:00:00Z"
    }
  ],
  "pagination": { "limit": 10, "has_more": false, "next_cursor": null }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`