Skip to main content
GET
List campaigns

Authorizations

Authorization
string
header
required

Workspace-scoped token sent in the Authorization header as Bearer . Access depends on the credential's allowed operations, read or write scope, and workspace subscription. Use an API key issued in the tracker for Public API v1. MCP uses separate OAuth credentials.

Query Parameters

includeArchived
string

Set to 1 to include archived and paused campaigns. Otherwise only active campaigns are listed. Ignored when ids is present.

limit
integer
default:100

Defaults to 100. Positive integers above 200 are clamped to 200. Invalid or nonpositive values fall back to 100. There is no cursor or offset pagination.

Required range: 1 <= x <= 200
query
string

Search by full or partial name, display name, ID, or tracking domain hostname. Wildcards are not supported.

ids
string

Comma-separated IDs, trimmed and deduplicated, then truncated to limit. Presence bypasses query and status filters. An empty list returns no campaigns.

q
string

Alias for query, used only when query is absent.

Response

Campaign list

ok
enum<boolean>
required
Available options:
true
data
object
required