Skip to main content
GET
/
advertisers
List advertisers
curl --request GET \
  --url https://api.interchange.io/api/v2/buyer/advertisers \
  --header 'Authorization: Bearer <token>'
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.interchange.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key or access token

Query Parameters

​
status
enum<string>
default:ACTIVE

Filter by advertiser status. Use ALL to include both active and archived. Defaults to ACTIVE.

Available options:
ACTIVE,
ARCHIVED,
ALL
​
name
string

Filter by advertiser name (case-insensitive, partial match)

Example:

"Acme"

​
sandbox
boolean

Filter by sandbox mode. true returns only sandbox advertisers, false returns only production advertisers. Omit to return all.

​
limit
integer
default:100

Maximum number of advertisers to return per page (default: 100, max: 100)

Required range: x <= 100
Example:

100

​
offset
integer
default:0

Number of advertisers to skip for pagination (default: 0)

Required range: 0 <= x <= 9007199254740991
Example:

0

Response

List advertisers