Skip to main content
GET
/
api
/
v1
/
campaigns
List Campaigns
curl --request GET \
  --url https://api.sequenzy.com/api/v1/campaigns \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "campaigns": [
    {
      "id": "camp_abc123",
      "name": "April Launch",
      "subject": "A quick update",
      "status": "draft",
      "labels": ["edm"],
      "scheduledAt": null,
      "sentAt": null,
      "createdAt": "2026-05-01T10:30:00Z",
      "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
      "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "count": 1,
    "total": 1,
    "hasMore": false
  }
}
List campaigns for the authenticated company. You can filter by status or label. Results are ordered newest first. The default page size is 50, and limit is capped at 100.

Request

status
string
Optional status filter: draft, scheduled, sent, sending, cancelled, paused, or waiting_approval.
label
string
Optional label name filter. Only campaigns assigned this label are returned.
limit
integer
Optional page size. Defaults to 50; maximum 100.
offset
integer
Optional zero-based row offset. Defaults to 0.
curl "https://api.sequenzy.com/api/v1/campaigns?status=draft&label=edm&limit=100&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

Responses

{
  "success": true,
  "campaigns": [
    {
      "id": "camp_abc123",
      "name": "April Launch",
      "subject": "A quick update",
      "status": "draft",
      "labels": ["edm"],
      "scheduledAt": null,
      "sentAt": null,
      "createdAt": "2026-05-01T10:30:00Z",
      "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
      "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "count": 1,
    "total": 1,
    "hasMore": false
  }
}