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. This endpoint normally requires a Buyer Account. A Seller Account in the Media Company V3 preview may use this list endpoint to populate its native Campaigns workspace. For that Seller-only compatibility read, an omitted sandbox parameter or sandbox=true returns only sandbox Advertisers with an active organization-owned binding to that Seller Account’s Storefront — available to every Seller Account, no rollout enrollment required. sandbox=false returns the same Seller Account’s live own-supply Advertisers instead, and requires the account to be enrolled in the amc-campaign-management rollout; an unenrolled Seller Account gets 403 OWN_SUPPLY_SCOPE_REQUIRED for that request. Unbound Advertisers in either environment are not part of this roster. The Campaigns workspace also uses two narrowly scoped compatibility reads: List campaigns for a bound Advertiser and that Advertiser’s promoted Creative list. Advertiser detail, Campaign and Creative detail, mutations, and reporting remain unavailable through Buyer REST to the Seller Account.

​
Request

curl

​
Parameters

​
Response

Summary rows also carry brandCountries, primaryCurrency, preferredTimezone, reportingTimezoneLocked, channels, and currencyLocked, so account setup can render without fetching every full advertiser. Market and channel values are advertiser planning inputs; seller selection remains account-wide. linkedAccountCount replaces the embedded account list. When hasMore is true, pass nextOffset as the next offset.

​
Errors

  • 400 VALIDATION_ERROR — invalid status value or out-of-range limit.
  • 403 CUSTOMER_ROLE_DENIED — the account is neither a Buyer Account nor a Seller Account using this advertiser roster.
  • 403 OWN_SUPPLY_SCOPE_REQUIRED — the Seller Account has no active Storefront scope for the requested environment’s roster, or requested sandbox=false without amc-campaign-management enrollment.
The Seller sandbox roster is available by account role; it does not require a separate entitlement or rollout enrollment. The Seller live roster additionally requires amc-campaign-management enrollment. All mutations remain outside this compatibility read. See Errors for the full error contract.

Advertiser tasks

All advertiser operations

Advertiser overview

Fields, lifecycle, and concepts

List organization advertisers

Read the authorized account-spanning roster

Get advertiser

Fetch the full resource

Create advertiser

Open a new advertiser