Get storefront

GET /api/v2/buyer/storefronts/{storefrontId} Returns a single storefront with canonical transaction readiness and separate rolled-up connection state: connected, requiresCredentials, and your registered customerAccounts. Use readiness.canTransact for availability. Use connection fields to diagnose buyer credential setup, for example after registering credentials or completing OAuth. Use the capabilities endpoint when you need source-level diagnostic rows.

Request

curl

curl https://api.interchange.io/api/v2/buyer/storefronts/42 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	In	Type	Required	Notes
`storefrontId`	path	integer	Yes	Storefront ID to fetch

Response

{
  "id": 42,
  "platformId": "premium-ctv",
  "name": "Premium CTV Storefront",
  "publisherDomain": "premium-ctv.example.com",
  "displayStatus": "neutral",
  "readiness": {
    "canTransact": true,
    "effectiveStatus": "live",
    "blockerIds": []
  },
  "channels": ["CTV", "display"],
  "adapterProviderType": null,
  "supportedRoutingTypes": ["DECISIONED", "ROUTED"],
  "regions": ["US", "EMEA"],
  "connected": false,
  "requiresCredentials": true,
  "customerAccounts": [
    {
      "accountIdentifier": "buyer-seat-123",
      "status": "ACTIVE"
    }
  ],
  "adcpCapabilities": null
}

Field	Type	Notes
`id`	integer	Storefront ID
`platformId`	string	Public-facing slug
`name`	string	Storefront display name
`publisherDomain`	string \| null	Publisher domain
`displayStatus`	enum	Deprecated stored-control compatibility label; not purchasing availability
`readiness.canTransact`	boolean	Canonical answer to whether ordinary buyer traffic may transact now
`readiness.effectiveStatus`	enum	`archived`, `paused`, `blocked`, or `live`
`readiness.blockerIds`	string[]	Machine-readable blocker IDs; empty when live
`channels` / `regions`	array	Supported channels and covered regions
`adapterProviderType`	string \| null	Adapter platform, `null` for non-adapter
`supportedRoutingTypes`	array	`DECISIONED` and/or `ROUTED`
`connected`	boolean	Whether the buyer has the required credentials/account setup. This does not mean the seller is transaction-ready.
`requiresCredentials`	boolean	Whether any source behind the storefront requires buyer credentials
`customerAccounts`	array	Registered buyer accounts, deduped across the storefront
`adcpCapabilities`	object \| null	Rolled-up capability manifest when cached capability data exists

Errors

401 UNAUTHORIZED — missing or invalid bearer token.
404 NOT_FOUND — the storefront does not exist or is not visible to the caller.

See Errors for the full error contract.

Storefront tasks

All storefront operations

Register source credentials

Connect a source that requires credentials

List storefronts

Paginated summaries

Get storefront capabilities

Source-level capability diagnostics

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Storefront tasks

Register source credentials

List storefronts

Get storefront capabilities

​Request

​Parameters

​Response

​Errors

​Related

Storefront tasks

Register source credentials

List storefronts

Get storefront capabilities

Request

Parameters

Response

Errors

Related