Get storefront
Get a single storefront with rolled-up buyer connection status.
Authorizations
API key or access token
Path Parameters
Storefront ID
1 <= x <= 9007199254740991Response
Get storefront
A storefront as seen by a buyer
Storefront ID
-9007199254740991 <= x <= 9007199254740991Public-facing slug
Storefront display name
Publisher domain
Operator-owned or resolved brand name shown on storefront discovery cards.
Operator-owned or resolved logo URL shown on storefront discovery cards.
Backdrop the logo is designed for, from brand.json. Null when unknown.
Operator-curated description shown on storefront discovery cards.
Operator-curated website URL shown on storefront discovery cards.
Validated brand.json colors object for rendering buyer discovery cards. Null when unresolved.
Canonical storefront identity and coverage used by every marketplace card renderer.
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.
configuring, transacting, archived, neutral, paused Canonical transaction eligibility for this storefront. This is independent of buyer credential connection state.
Ad channels this storefront supports (e.g. "display", "CTV", "audio"). Empty array if not specified.
Adapter platform type (e.g. "meta", "tiktok"). Null for non-adapter storefronts.
Adapter family for official adapter storefronts, such as sales or creative. Null for non-adapter storefronts.
sales, creative, signals, measurement, optimization, composite Creative-generation capabilities when this is a creative adapter storefront; null otherwise.
Buyer-specific connection state for official adapter storefronts; null for non-adapter storefronts or when connection state was not requested.
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.
DECISIONED, ROUTED 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.
1operator, agent, advertiser 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.
Whether every inventory source the buyer needs is connected. This is buyer credential wiring, not storefront transaction readiness; use readiness.canTransact for availability.
Whether the buyer must register credentials before they can transact with this storefront.
The buyer's registered accounts for this storefront, aggregated across its inventory sources and deduped by accountIdentifier.
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.
Observed response-time stats from buyer product discovery. Use this to decide whether to ask the user before running a long discovery wait.