Skip to main content
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

FieldTypeRequiredNotes
statusenumNoACTIVE, ARCHIVED, or ALL. Defaults to ACTIVE
namestringNoCase-insensitive partial match on advertiser name
sandboxbooleanNotrue returns only sandbox advertisers, false only production. Omit for all
linkedAccountPartnerIdstringNoExact partner / sales-agent ID. Returns only advertisers with a currently linked account for that partner
limitintegerNoMax rows per page. Default 100, max 100
offsetintegerNoRows 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