Skip to main content
GET
List advertisers

Authorizations

X-API-Key
string
header
required

Preferred authentication method. Pass the API key in the X-API-Key HTTP request header. The user account must have api_status enabled.

Query Parameters

page
integer

Page number.

perPage
integer

Items per page.

sortField
string

Sort field.

sortDirection
enum<string>

Sort direction.

Available options:
asc,
desc

Search by text or ID.

status
enum<string>

Filter by advertiser account status. One value only — a comma-separated list is not supported and falls back to the unfiltered list, as does any unrecognised value (200, no error). Deleted accounts (status 5) are never returned by this endpoint and cannot be selected with any value.

Available options:
active,
pending,
inactive
fields
string

Comma-separated list of top-level response fields to return, e.g. fields=id,status,targeting. When omitted, the full field set for your role is returned. Unknown field names are ignored silently — the response still returns 200 with the recognised fields only. Not supported on the reporting endpoints: those select their payload with columns instead.

Response

Advertisers list.

status
string
Example:

"success"

code
integer
Example:

200

name
string
Example:

"OK"

message
string
info
object