List Ad Campaigns
Lists the ad campaigns for an account, with stats over the requested window.
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Headers
Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version.
"2026-06-20"
Query Parameters
The account the campaigns belong to. Defaults to the account-scoped key's own account.
Only return campaigns with this status.
draft, active, paused, payment_failed Filter campaigns by a title or ID substring.
The field to sort by. Defaults to created_at.
created_at, updated_at The sort direction. Defaults to desc.
asc, desc Only return campaigns created before this timestamp.
Only return campaigns created after this timestamp.
Start of the stats window. Defaults to all-time.
End of the stats window. Defaults to now.
The number of campaigns to return.
x <= 100Cursor to fetch the page after (from page_info.end_cursor).
The number of campaigns to return from the end of the range.
x <= 100Cursor to fetch the page before (from page_info.start_cursor).

