Skip to main content
GET
List storefronts

Authorizations

Authorization
string
header
required

API key or access token

Query Parameters

name
string

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

Alias of name (same partial, case-insensitive match). When both are sent, name wins.

status
enum<string>

Filter by stored-control labels. neutral and paused match isPaused; legacy configuring and transacting match the compatibility field; archived matches archived storefronts. This is not transaction readiness.

Available options:
configuring,
transacting,
archived,
neutral,
paused
channel
string

Filter to storefronts that carry this channel. Canonical AdCP values such as display, olv, and ctv are recommended; legacy/custom strings remain accepted for compatibility.

Minimum string length: 1
region
string

Filter to storefronts that sell in this country. Accepts an ISO 3166-1 alpha-2 country code (e.g. FR, US, JP), a country group (NAM, LATAM, EMEA, EUROPE, EU, APAC), or WORLDWIDE (every storefront matches). A storefront matches when it sells in the country or any country of the group, accepts every country, or names no country (so is in every country). Legacy aliases such as GLOBAL, NORAM, NA and UK are still read; any other value matches only storefronts that are in every country.

Minimum string length: 1
visibility
enum<string>

Which storefronts to list. public (default) returns human-reviewed storefronts listed in the buyer marketplace. private returns ALL storefronts (configuring, transacting, archived, hidden, or pending review) owned by customers in the caller's parent organization.

Available options:
public,
private
publisherDomain
string

Find sellers that represent this publisher. Returns storefronts whose declared publisher coverage includes this domain or any of its subdomains. Use this for vendor selection — identifying which sellers cover a publisher you care about. This is a coverage filter, not an inventory query; for domain-level product availability use product discovery.

limit
integer

Maximum storefronts per page (default: 20, max: 100)

Required range: 0 < x <= 100
offset
integer

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

Required range: 0 <= x <= 9007199254740991

Response

List storefronts

Paginated list of storefront summaries available to a buyer

items
object[]
required
total
integer
required
Required range: 0 <= x <= 9007199254740991
hasMore
boolean
required
nextOffset
integer | null
required
Required range: 0 <= x <= 9007199254740991