Skip to main content
GET
/
advertisers
List advertisers
curl --request GET \
  --url https://api.agentic.scope3.com/api/v2/buyer/advertisers \
  --header 'Authorization: Bearer <token>'
{
  "error": "<string>",
  "message": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key or access token

Query Parameters

​
status
enum<string>
default:ACTIVE

Filter by advertiser status. Use ALL to include both active and archived. Defaults to ACTIVE.

Available options:
ACTIVE,
ARCHIVED,
ALL
​
name
string

Filter by advertiser name (case-insensitive, partial match)

Example:

"Acme"

​
includeBrand
boolean

Include resolved brand information (logos, colors, industry) for each advertiser

​
includeAccounts
boolean

Include linked partner accounts for each advertiser. Default: true.

​
sandbox
boolean

Filter by sandbox mode. true returns only sandbox advertisers, false returns only production advertisers. Omit to return all.

​
limit
integer
default:100

Maximum number of advertisers to return per page (default: 100, max: 100)

Required range: x <= 100
Example:

100

​
offset
integer
default:0

Number of advertisers to skip for pagination (default: 0)

Required range: 0 <= x <= 9007199254740991
Example:

0

Response

List advertisers