Skip to main content
GET
Get storefront

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

storefrontId
integer
required

Storefront ID

Required range: 1 <= x <= 9007199254740991

Response

Get storefront

A storefront as seen by a buyer

id
integer
required

Storefront ID

Required range: -9007199254740991 <= x <= 9007199254740991
platformId
string
required

Public-facing slug

name
string
required

Storefront display name

publisherDomain
string | null
required

Publisher domain

brandName
string | null
required

Operator-owned or resolved brand name shown on storefront discovery cards.

logoUrl
string | null
required

Operator-owned or resolved logo URL shown on storefront discovery cards.

logoBackground
string | null
required

Backdrop the logo is designed for, from brand.json. Null when unknown.

description
string | null
required

Operator-curated description shown on storefront discovery cards.

website
string | null
required

Operator-curated website URL shown on storefront discovery cards.

brandColors
object | null
required

Validated brand.json colors object for rendering buyer discovery cards. Null when unresolved.

discoveryCard
object
required

Canonical storefront identity and coverage used by every marketplace card renderer.

displayStatus
enum<string>
required

Deprecated stored-control label. Legacy projections retain configuring and transacting; projections backed by isPaused return neutral or paused. archived overrides both. Use readiness.effectiveStatus and readiness.canTransact for actual availability.

Available options:
configuring,
transacting,
archived,
neutral,
paused
readiness
object
required

Canonical transaction eligibility for this storefront. This is independent of buyer credential connection state.

channels
string[]
required

Ad channels this storefront supports (e.g. "display", "CTV", "audio"). Empty array if not specified.

Example:
adapterProviderType
string | null
required

Adapter platform type (e.g. "meta", "tiktok"). Null for non-adapter storefronts.

adapterSourceKind
enum<string> | null
required

Adapter family for official adapter storefronts, such as sales or creative. Null for non-adapter storefronts.

Available options:
sales,
creative,
signals,
measurement,
optimization,
composite
creativeCapabilities
object | null
required

Creative-generation capabilities when this is a creative adapter storefront; null otherwise.

adapterConnection
object | null
required

Buyer-specific connection state for official adapter storefronts; null for non-adapter storefronts or when connection state was not requested.

supportedRoutingTypes
enum<string>[]
required
deprecated

Deprecated v2 compatibility placeholder. Every storefront returns both legacy values. Do not use this field for storefront type, targeting, eligibility, execution, connectivity, or settlement; use explicit capabilities, authentication state, and BillingParty instead.

Available options:
DECISIONED,
ROUTED
supportedBilling
enum<string>[]
required

Supported billing parties for media bought from this storefront, using AdCP BillingParty vocabulary (who is invoiced): agent means Interchange clears the transaction and bills the buyer; operator/advertiser mean the seller or connected platform bills the account operator or advertiser directly — Interchange never touches the media money. Adapter storefronts are always operator/advertiser.

Minimum array length: 1
Available options:
operator,
agent,
advertiser
regions
string[]
required

Operator-curated regions this storefront covers (ISO 3166-1 alpha-2 country codes or group codes like WORLDWIDE, EMEA, NORAM). Empty array if not specified.

Example:
connected
boolean
required

Whether every inventory source the buyer needs is connected. This is buyer credential wiring, not storefront transaction readiness; use readiness.canTransact for availability.

requiresCredentials
boolean
required

Whether the buyer must register credentials before they can transact with this storefront.

customerAccounts
object[]
required

The buyer's registered accounts for this storefront, aggregated across its inventory sources and deduped by accountIdentifier.

adcpCapabilities
object | null
required

AdCP capability manifest for the storefront's underlying agent(s). Non-null for agent-based storefronts with cached capability data; null for adapter storefronts or when no capability data has been fetched yet.

discoveryPerformance
object
required

Observed response-time stats from buyer product discovery. Use this to decide whether to ask the user before running a long discovery wait.

publishers
object | null