Get storefront

GET /api/v2/buyer/storefronts/{storefrontId} Returns a single storefront with rolled-up connection state: connected, requiresCredentials, and your registered customerAccounts. Use it to check fresh storefront state — for example, after registering credentials or completing an OAuth flow. 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": "transacting",
  "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	`configuring`, `transacting`, `archived`
`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 to use the storefront
`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