> ## Documentation Index
> Fetch the complete documentation index at: https://docs.foxreach.io/llms.txt
> Use this file to discover all available pages before exploring further.
# List Campaigns
> Retrieve a paginated list of campaigns in your workspace.
## Query Parameters
Page number (starts at 1).
Number of campaigns per page (1-100).
Filter by status: `draft`, `active`, `paused`, or `completed`.
## Response
Array of campaign objects.
Unique campaign identifier.
Campaign name.
Campaign status: `draft`, `active`, `paused`, `completed`.
Sending timezone (e.g., `UTC`, `America/New_York`).
Days of the week to send (1=Mon, 7=Sun).
Start hour for sending (0-23).
End hour for sending (0-23).
Maximum emails per day.
Emails sent today.
AI context for draft replies.
Total leads enrolled.
Total emails sent.
Total emails delivered.
Total bounced emails.
Total replies received.
Total email opens.
ISO 8601 timestamp.
ISO 8601 timestamp.
When the campaign was first started.
When the campaign completed.
```bash cURL theme={null}
curl -X GET "https://api.foxreach.io/api/v1/campaigns?status=active" \
-H "X-API-Key: otr_your_key"
```
```python Python SDK theme={null}
from foxreach import FoxReach
client = FoxReach(api_key="otr_your_key")
campaigns = client.campaigns.list(status="active")
```
```typescript TypeScript SDK theme={null}
import { FoxReach } from "foxreach";
const client = new FoxReach({ apiKey: "otr_your_key" });
const campaigns = await client.campaigns.list({ status: "active" });
```
```json theme={null}
{
"data": [
{
"id": "cmp_abc123",
"name": "Q1 Outreach",
"status": "active",
"timezone": "America/New_York",
"sendingDays": [1, 2, 3, 4, 5],
"sendingStartHour": 9,
"sendingEndHour": 17,
"dailyLimit": 50,
"sentToday": 12,
"context": null,
"totalLeads": 500,
"totalSent": 234,
"totalDelivered": 230,
"totalBounced": 4,
"totalReplied": 18,
"totalOpened": 87,
"createdAt": "2025-01-10T08:00:00",
"updatedAt": "2025-01-15T10:30:00",
"startedAt": "2025-01-10T09:00:00",
"completedAt": null
}
],
"meta": {
"page": 1,
"pageSize": 20,
"total": 1,
"totalPages": 1
}
}
```
## Rate Limit
* **100 requests per minute, per API key.** Fixed 60-second window.
* Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` (unix epoch seconds).
* 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](/rate-limiting).