OpenAPI 3.0.0raw.githubusercontent.com2026-08-173173871.1 MB

fcb2ecfdfabd

Reach: Campaigns

List campaigns

Get a paginated list of the campaigns in a profile.

Each campaign carries its headline engagement rates. Filter by status to find drafts, scheduled, sending or sent campaigns, keeping in mind that a fully sent campaign has the status publish. By default only regular campaigns are returned - pass type to get the emails sent by automations or the double opt-in confirmations instead.

get/api/reach/v1/profiles/{profileUuid}/campaigns

Path parameters

profileUuidstring required
Example:550e8400-e09b-41d4-a716-400055000000

Profile uuid parameter

Query parameters

status'draft' | 'scheduled' | 'sending' | 'publish' | 'failed'
Example:publish

Filter campaigns by status.

A fully sent campaign has the status publish. There is no sent status, and campaigns can be neither paused nor archived.

type'campaign' | 'automation' | 'double_opt_in'
Example:campaign

Filter campaigns by type.

Defaults to campaign, which leaves out the emails sent by automations and the double opt-in confirmations.

sort_direction'asc' | 'desc'
Example:desc

Order campaigns by creation date. Newest first unless set to asc.

pageinteger
Example:1

Page number

per_pageinteger
Example:25

Number of items per page

Response

Success response

Example response

{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Black Friday Campaign",
      "subject": "Don't miss our Black Friday deals!",
      "sender_name": "Marketing Team",
      "sender_email": "marketing@example.com",
      "template_uuid": "2080cc86-e026-4f7b-9598-d4132f8c7c2f",
      "status": "publish",
      "type": "campaign",
      "created_at": "2025-02-27T11:54:22Z",
      "updated_at": "2025-03-04T09:12:07Z",
      "sent_at": "2025-03-04T09:12:07Z",
      "scheduled_at": "2025-03-04T08:00:00Z",
      "statistics": {
        "total_sent": 100,
        "open_rate": 42.5,
        "click_rate": 10,
        "click_to_open_rate": 23.5
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 100
  }
}