---
title: "List campaigns"
method: GET
path: "/campaigns"
tags: ["Campaigns"]
---

# List campaigns

`GET /campaigns`

Lists campaigns for the authenticated company, optionally filtered by status or label.

## Query parameters

- `status` 'draft' | 'scheduled' | 'sent' | 'sending' | 'cancelled' | 'paused' | 'waiting_approval'
- `label` string
- `limit` integer
- `offset` integer

## Response `200`

Campaigns returned

- object
  - `success` boolean
  - `campaigns` CampaignSummary[]
    - `id` string
    - `name` string
    - `subject` string
    - `status` string
    - `trackingCode` string, nullable — Campaign tracking code available to UTM templates as `{{campaign.trackingCode}}`.
    - `labels` string[] — Label names assigned to this campaign.
    - `scheduledAt` string, date-time, nullable
    - `sentAt` string, date-time, nullable
    - `createdAt` string, date-time
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `total` integer
    - `hasMore` boolean

## Other responses

- `400` — Invalid filter or pagination parameter
- `401` — Unauthorized

## Changes

- **2026-06-19** `ba95c77d23ef` — 3 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the optional property `pagination` to the response with the `200` status
- **2026-05-19** `1a51a400be50` — 1 info
  - added the optional property `campaigns/items/trackingCode` to the response with the `200` status
- **2026-05-15** `b040bb8c6608` — 1 info
  - added the new enum value `waiting_approval` to the `query` request parameter `status`
- **2026-05-13** `9a89cb9ec599` — 2 info
  - added the new optional `query` request parameter `label`
  - added the optional property `campaigns/items/labels` to the response with the `200` status
- **2026-05-11** `ee7b7111c55b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/campaigns/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/fd494fa7e64d/schema)