List advertisers

GET /api/v2/buyer/advertisers Returns a paginated list of advertiser summary rows. Each row is the compact shape — call Get advertiser for the full resource with brand, linked accounts, UTM config, and frequency caps.

Request

curl

curl "https://api.interchange.io/api/v2/buyer/advertisers?status=ACTIVE&limit=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`status`	enum	No	`ACTIVE`, `ARCHIVED`, or `ALL`. Defaults to `ACTIVE`
`name`	string	No	Case-insensitive partial match on advertiser name
`sandbox`	boolean	No	`true` returns only sandbox advertisers, `false` only production. Omit for all
`linkedAccountPartnerId`	string	No	Exact partner / sales-agent ID. Returns only advertisers with a currently linked account for that partner
`limit`	integer	No	Max rows per page. Default `100`, max `100`
`offset`	integer	No	Rows to skip for pagination. Default `0`

Response

{
  "items": [
    {
      "id": "12345",
      "name": "Acme Corp",
      "status": "ACTIVE",
      "sandbox": false,
      "brand": "acme.com",
      "primaryCurrency": "USD",
      "linkedAccountCount": 3,
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-20T14:45:00Z"
    }
  ],
  "total": 42,
  "hasMore": false,
  "nextOffset": null
}

linkedAccountCount replaces the embedded account list on summary rows. When hasMore is true, pass nextOffset as the next offset.

Errors

400 VALIDATION_ERROR — invalid status value or out-of-range limit.

See Errors for the full error contract.

Advertiser tasks

All advertiser operations

Advertiser overview

Fields, lifecycle, and concepts

Get advertiser

Fetch the full resource

Create advertiser

Open a new advertiser

Get advertiser List audiences

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Advertiser tasks

Advertiser overview

Get advertiser

Create advertiser

​Request

​Parameters

​Response

​Errors

​Related

Advertiser tasks

Advertiser overview

Get advertiser

Create advertiser

Request

Parameters

Response

Errors

Related