Get advertiser - Interchange API

GET /api/v2/buyer/advertisers/{advertiserId} Returns a single advertiser with full brand details — including the resolved ADCP manifest — plus linked accounts, UTM config, and frequency caps.

Request

curl

curl https://api.interchange.io/api/v2/buyer/advertisers/12345 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`advertiserId`	string (path)	Yes	Unique identifier for the advertiser

Response

{
  "id": "12345",
  "name": "Acme Corp",
  "description": "Global advertising account for Acme Corporation",
  "status": "ACTIVE",
  "sandbox": false,
  "brand": "acme.com",
  "primaryCurrency": "USD",
  "optimizationApplyMode": "MANUAL",
  "linkedBrand": {
    "id": "brand_123",
    "name": "Acme Brand",
    "domain": "acme.com",
    "manifest": { "name": "Acme Corporation", "url": "https://www.acme.com" }
  },
  "frequencyCaps": [
    {
      "id": "fc_1",
      "max_impressions": 3,
      "window": { "interval": 7, "unit": "days" },
      "targetLevel": "ADVERTISER",
      "targetId": "12345",
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-15T10:30:00Z"
    }
  ],
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-20T14:45:00Z"
}

The single-advertiser endpoint always returns the resolved linkedBrand (with the full ADCP manifest). linkedAccounts, utmConfig, and frequencyCaps appear when configured. A brandWarning is present when the brand reference could not be resolved.

Errors

404 NOT_FOUND — advertiserId does not exist or is not visible to the authenticated account.

See Errors for the full error contract.

Advertiser tasks

All advertiser operations

Advertiser overview

Fields, lifecycle, and concepts

List advertisers

Page through summary rows

Update advertiser

Change name, brand, or defaults

Execute catalog activation List advertisers

⌘I

​Request

​Parameters

​Response

​Errors

​Related