List storefronts

GET /api/v2/buyer/storefronts Lists storefronts visible to the buyer as compact summary rows. Each row carries canonical transaction readiness plus scalar buyer-connection counts instead of source-level detail. A listed storefront can still be unavailable while its seller finishes setup. Fetch a single storefront for rolled-up connection state, or fetch storefront capabilities for source-level diagnostic rows. Filterable and offset-paginated.

Request

curl "https://api.interchange.io/api/v2/buyer/storefronts?limit=20" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

curl "https://api.interchange.io/api/v2/buyer/storefronts?name=premium&channel=ctv&limit=20" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	In	Type	Required	Notes
`name`	query	string	No	Partial, case-insensitive seller, company, brand, storefront, publisher/operator domain, or website match
`status`	query	enum	No	Deprecated stored-control filter: `neutral`, `paused`, `configuring`, `transacting`, or `archived`. This is not transaction readiness.
`channel`	query	string	No	ADCP channel the storefront carries (e.g. `display`, `ctv`)
`region`	query	string	No	Region code the storefront covers (e.g. `EMEA`, `NORAM`, `APAC`)
`visibility`	query	enum	No	`public` (default) — marketplace-listed storefronts; `private` — all storefronts owned by the caller’s parent org
`limit`	query	integer	No	Max per page (default 20, max 100)
`offset`	query	integer	No	Pagination offset (default 0)

Response

{
  "items": [
    {
      "id": 42,
      "platformId": "premium-ctv",
      "name": "Premium CTV Storefront",
      "publisherDomain": "premium-ctv.example.com",
      "displayStatus": "neutral",
      "readiness": {
        "canTransact": true,
        "effectiveStatus": "live",
        "blockerIds": []
      },
      "adapterProviderType": null,
      "supportedRoutingTypes": ["DECISIONED", "ROUTED"],
      "channels": ["CTV", "display"],
      "regions": ["US", "EMEA"],
      "sourceCount": 3,
      "connectedSourceCount": 1
    }
  ],
  "total": 1,
  "hasMore": false,
  "nextOffset": null
}

Field	Type	Notes
`items`	array	Storefront summary rows
`items[].id`	integer	Storefront ID
`items[].platformId`	string	Public-facing slug
`items[].name`	string	Storefront display name
`items[].publisherDomain`	string \| null	Publisher domain
`items[].displayStatus`	enum	Deprecated stored-control compatibility label. Do not use it for purchasing availability.
`items[].readiness.canTransact`	boolean	Canonical answer to whether ordinary buyer traffic may transact now
`items[].readiness.effectiveStatus`	enum	`archived`, `paused`, `blocked`, or `live`
`items[].readiness.blockerIds`	string[]	Machine-readable blocker IDs; empty when live
`items[].adapterProviderType`	string \| null	Adapter platform (e.g. `meta`), `null` for non-adapter
`items[].supportedRoutingTypes`	array	`DECISIONED` and/or `ROUTED`
`items[].channels` / `regions`	array	Supported channels and covered regions
`items[].sourceCount`	integer	Total inventory sources
`items[].connectedSourceCount`	integer	Sources the buyer is already wired to use. This is credential connection state, not readiness.
`total`	integer	Total matching storefronts
`hasMore`	boolean	Whether more pages exist
`nextOffset`	integer \| null	Offset for the next page, or `null`

Errors

400 VALIDATION_ERROR — invalid status/visibility enum or out-of-range limit.
401 UNAUTHORIZED — missing or invalid bearer token.

See Errors for the full error contract.

Storefront tasks

All storefront operations

Get storefront

Rolled-up connection state

Get storefront capabilities

Source-level capability diagnostics

Storefront object guide

Full model: sources, OAuth, seller side

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

Get storefront

Get storefront capabilities

Storefront object guide

​Request

​Parameters

​Response

​Errors

​Related

Storefront tasks

Get storefront

Get storefront capabilities

Storefront object guide

Request

Parameters

Response

Errors

Related