List Campaigns
List all campaigns for the authenticated user.
GET
/campaignsList all campaigns with optional status filtering.
Query Parameters
Filter by status (draft, running, paused, completed)
Max results to return
Pagination offset
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | All | Filter by: draft, running, paused, completed, failed |
limit | integer | 20 | Maximum number of campaigns to return |
offset | integer | 0 | Pagination offset |
Response 200
{
"campaigns": [
{
"id": "camp_a1b2c3d4",
"name": "Follow-up Campaign",
"status": "running",
"type": "voice",
"agent_id": "ag_c47e7c97_b2f2",
"total_contacts": 150,
"completed": 45,
"failed": 3,
"created_at": "2026-03-07T14:00:00Z"
}
],
"total": 1
}Response Fields
| Field | Type | Description |
|---|---|---|
campaigns[].id | string | Campaign ID |
campaigns[].name | string | Campaign name |
campaigns[].status | string | draft, running, paused, completed, failed |
campaigns[].type | string | voice or sms |
campaigns[].total_contacts | integer | Total contacts in the campaign |
campaigns[].completed | integer | Successfully reached contacts |
campaigns[].failed | integer | Failed contact attempts |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |