# List Account Campaigns Beta

> The campaigns one email account is assigned to.

> Documentation index: https://www.foxreach.io/docs/llms.txt lists every page of these docs. Each page is also served as Markdown: add `.md` to its URL.

`GET` https://api.foxreach.io/api/v1/email-accounts/{account_id}/campaigns

> **Note:** **Beta.** This endpoint is new and may change before it is generally available.

Requires an API key with the `read` scope. Returns up to 100 campaigns, newest first.

## Path Parameters

- `account_id` string path required

  The unique identifier of the email account.

## Response

- `data` array

  - `id` string: Campaign identifier.
  - `name` string: Campaign name.
  - `status` string: `draft`, `active`, `paused` or `completed`.

**Request example**

```bash cURL
curl -X GET "https://api.foxreach.io/api/v1/email-accounts/cea_abc123/campaigns" \
  -H "X-API-Key: otr_your_key"
```

```python Python SDK (beta)
from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
campaigns = client.email_accounts.campaigns("cea_abc123")
```

```typescript TypeScript SDK (beta)
import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const campaigns = await client.emailAccounts.campaigns("cea_abc123");
```

**Response example**

```json
{
  "data": [
    { "id": "cmp_abc123", "name": "Q4 outbound", "status": "active" },
    { "id": "cmp_def456", "name": "Agency follow-ups", "status": "draft" }
  ]
}
```

## Errors

| Status | Description |
|--------|-------------|
| `401` | Missing, invalid, revoked or expired API key |
| `403` | API key does not have the required scope: `read` |
| `404` | Email account not found, or it belongs to another workspace |

## Rate Limit

- **600 requests per minute, shared by every `poll` call in your workspace.** Fixed 60-second window.
- Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (unix epoch seconds) and `X-RateLimit-Bucket` (`poll`).
- A `429` response includes a `Retry-After` header (seconds until the bucket resets).

For client-side patterns (`Retry-After`, exponential backoff, monitoring `X-RateLimit-Remaining`), see [Rate Limiting](https://www.foxreach.io/docs/rate-limiting).
