List the campaigns
GET
/api/v1/campaigns
The campaigns of the token's account, a page at a time.
Parameters
page
integer
query
Default:
1
per_page
integer
query
Campaigns per page.
Default:
10Responses
200
One page of campaigns.
401
The token is missing or wrong (
Unauthenticated.), or its user may not act on
this object (Unauthorized). Without the Accept: application/json header, a
missing or wrong token answers with a redirect to the sign-in page instead.
List the campaigns
1
2
3
curl 'https://your-domain/api/v1/campaigns' \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
1
2
$client = new Acelle\Client('https://your-domain/api/v1', 'YOUR_API_TOKEN');
$client->campaign()->all(['page' => 1, 'per_page' => 10]);
Response
[
{
"id": 1,
"uid": "6adaabd2b4753",
"name": "November newsletter",
"type": "regular",
"subscribers": 1942,
"sent_percent": 0.61,
"sent_label": "1188/1942",
"open_rate": 0.39,
"click_rate": 0.04,
"archive_status": null,
"subject": "What's new this month",
"plain": "Hello, here is what changed this month.",
"from_email": "hello@example.com",
"from_name": "Example Team",
"reply_to": "hello@example.com",
"custom_headers": [],
"status": "done",
"delivery_at": "2026-11-03T09:00:00.000000Z",
"created_at": "2026-11-01T05:29:19.000000Z",
"updated_at": "2026-11-03T10:12:40.000000Z"
}
]