Get storefront
Get the authenticated customer’s storefront.
Authorizations
API key or access token
Response
Get storefront
Storefront configuration response
Surrogate id (BIGINT serialized as string)
"1234"
Public-facing slug
"acme-media"
Display name
"Acme Media"
Publisher domain for the storefront's business profile
"acme.com"
Canonical operator domain
"scope3.com"
Brand name from AAO registry
"Scope3"
Logo URL from brand.json
AAO membership tier. Null when the operator has not set a value.
AAO_FOUNDING_MEMBER, AAO_MEMBER, NONE Legacy merchandising-region context projected from businessProfile. This does not govern brief acceptance or Discovery Card country coverage.
Operator-confirmed exhaustive country allowlist for brief routing. Null means routing scope has not been confirmed.
^[A-Z]{2}$Whether the operator explicitly accepts briefs from every country.
Seller-selected Business Rules sections disclosed publicly as Advertising Policies. Empty means no local disclosure.
A Business Rules section the seller elects to disclose publicly as Advertising Policies on its Discovery Card.
brief_acceptance, creative_policy Standard primary countries advertised by backing AdCP sales agents. Authoritative for a pure pass-through Discovery Card; inventory evidence otherwise.
^[A-Z]{2}$Standard primary channels advertised by backing AdCP sales agents. Authoritative for a pure pass-through Discovery Card; inventory evidence otherwise.
Operator-curated description (overrides brand.json).
ADCP channel codes the storefront offers.
Operator-curated website URL (overrides brand.json).
Canonical buyer-visible storefront identity and coverage. This is distinct from Media Kit merchandising inputs and seller policies.
Demand contact name. Null when the operator has not set one.
Demand contact email. Null when the operator has not set one.
Whether the operator domain has been verified (email match or manual KYC)
Which backend function the buyer-facing storefront dispatches to: the Merchandising Agent or an expert-run adapter.
CHEF, ADAPTER Expert-run adapter provider when routingMode is ADAPTER; null otherwise.
amazon, audiostack, elevenlabs, fal, gemini, google, linkedin, meta, openai, pinterest, reddit, snap, spotify, tiktok, veo Adapter role when routingMode is ADAPTER; null otherwise.
sales, creative, signals, measurement, optimization, composite Adapter credential mode when routingMode is ADAPTER; null otherwise.
BYOK Storefront plan tier
basic Deprecated compatibility projection of !isPaused; not proof that the storefront currently satisfies readiness.
Compatibility-named seller intake hold. True blocks discovery, new buys, and buyer edits but does not pause existing delivery. False is neutral; it does not by itself make the storefront live.
When the storefront was archived (read-only thereafter). Null for non-archived storefronts.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Deprecated stored-control display status. This is never proof that the storefront can transact; use the readiness projection.
configuring, transacting, archived, neutral, paused Effective buyer-facing AdCP capabilities. Product composition derives from merchandising access and ready Source product paths; it is not locked to the legacy configured flag.
Persisted operator capability flags before source-topology derivation. Compare this field for declarative writes; capabilities is the effective buyer-facing projection.
Composition pricing settings: fallback pricing percentile plus seller pricing facts. Separate from Scope3 contract/billing rate cards.
Stored operator setting for creative submissions. It only affects ad-server-backed or product-composition storefronts; pass-through external-agent storefronts ignore this because their sources own review.
auto, manual Stored operator setting for new media buys. It only affects ad-server-backed or product-composition storefronts; pass-through external-agent storefronts ignore this because Interchange does not insert an approval queue.
auto, manual Legacy topology projection: true when the storefront has at least one active ad-server-backed inventory source (executionType=MANAGED_SALES_AGENT). Product composition is now Source-derived, so this value does not authorize or lock capability writes.
Derived: true when the Storefront has an active Inventory Source, an active embedded Sales Agent, adapter routing, or an advertised Storefront-owned capability. Every active Source remains behind the buyer-facing Storefront AdCP endpoint, including COMPOSING-only Sources.
Creation timestamp (ISO 8601)
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Last update timestamp (ISO 8601)
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$Operator-supplied business profile captured during Murph-led setup. Null when the operator has not shared one.
Backdrop the logo is designed for, from brand.json. Null or absent when unknown; the storefront card falls back to a dark tile.
dark-bg, light-bg, transparent-bg Declared selling intent from the first onboarding question, or null when the operator has not been asked yet. A record of the operator's answer — what the storefront exposes is always the derived capabilities.
third_party_connect, sell_through_scope3 Operator toggle: when true, the storefront also resells third-party inventory from other Interchange storefronts (composition draws from the marketplace in addition to its own sources). When false/absent (default), the storefront sells only its own inventory sources.
Seller-confirmed primary settlement currency (ISO-4217). Null until confirmed; required before go-live for Interchange-cleared storefronts. Direct sales adapter storefronts run by our expert agents skip settlement-currency readiness checks because Interchange does not pay the seller on that path.
ISO-4217 currencies the storefront will be paid in (the payout set). A media buy settles in one of these. Empty falls back to defaultCurrency. The marketplace may additionally accept buyer currencies outside this set via cross-currency FX, converting each source cost to the buyer currency at the platform spot rate.