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)

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 accept briefs in this ISO 3166-1 alpha-2 country (e.g. FR, US, JP). Legacy market-group and custom values remain accepted against legacy region declarations.

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: 1 <= 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