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>[]

Filter by status. Repeat the parameter to match any of several statuses (e.g. ?status=active&status=paused).

Campaign lifecycle status. draftpending_approval (submitted for Launchpoint review) → activepausedcompleted. A denied publish returns the campaign to draft with status_detail populated.

Available options:
draft,
pending_approval,
active,
paused,
completed
brand_id
string<uuid>

Narrow results to a single brand. Agency keys only; must be a brand the agency manages.

created_after
string<date-time>

Only campaigns created at or after this time (ISO 8601)

created_before
string<date-time>

Only campaigns created before this time (ISO 8601)

limit
integer
default:25

Number of items to return per page

Required range: 1 <= x <= 100
starting_after
string

Opaque pagination cursor from a previous response's next_cursor

Response

A page of campaigns

data
object[]
has_more
boolean
Example:

true

next_cursor
string | null

Pass as starting_after to fetch the next page. Null when there are no more results.

Example:

"Y2FtcGFpZ25fMTIz"