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

FieldTypeRequiredNotes
advertiserIdstring (path)YesUnique 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",
  "campaignBudgetType": "total_budget",
  "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 customer.
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