Campaigns

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: 10
Responses
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"
    }
]