Skip to main content
GET
List Campaigns

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status
enum<string> | null

Campaign status values.

SCORING and REVIEW_READY are the commonality-threshold extension states (plan 2026-05-21-commonality-threshold-filter, AC-17 / B2). They are enumerated here so that every reader of campaigns.status sees the full set; the DB CHECK constraint expansion lives in PR-2a. Until COMMONALITY_THRESHOLD_ENABLED=true, no campaign row should carry these values in production (feature-flag-gated at the customer-entry endpoints — see plan §"Feature flag policy").

Available options:
draft,
launching,
scoring,
review_ready,
scheduled,
active,
draining,
paused,
completed,
failed
search
string | null

Search by campaign name

page
integer
default:1

Page number

Required range: x >= 1
page_size
integer
default:20

Items per page

Required range: 1 <= x <= 100

Response

Successful Response

Response model for campaign list.

campaigns
CampaignListItem · object[]
required

List of campaigns

total
integer
required

Total number of campaigns

page
integer
required

Current page number

page_size
integer
required

Items per page