Skip to main content
GET /api/v2/buyer/storefronts Lists the enabled storefronts visible to the buyer, as compact summary rows. Each summary carries scalar source counts instead of the embedded sources[] array — fetch a single storefront for the full source list. Filterable and offset-paginated.

​
Request

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

​
Parameters

FieldInTypeRequiredNotes
namequerystringNoPartial, case-insensitive match on storefront name
statusqueryenumNoconfiguring, transacting, or archived
channelquerystringNoADCP channel the storefront carries (e.g. display, ctv)
regionquerystringNoRegion code the storefront covers (e.g. EMEA, NORAM, APAC)
visibilityqueryenumNopublic (default) — marketplace-listed storefronts; private — all storefronts owned by the caller’s parent org
limitqueryintegerNoMax per page (default 20, max 100)
offsetqueryintegerNoPagination offset (default 0)

​
Response

{
  "items": [
    {
      "id": 42,
      "platformId": "premium-ctv",
      "name": "Premium CTV Storefront",
      "publisherDomain": "premium-ctv.example.com",
      "displayStatus": "transacting",
      "adapterProviderType": null,
      "supportedCampaignTypes": ["DECISIONED", "ROUTED"],
      "channels": ["CTV", "display"],
      "regions": ["US", "EMEA"],
      "sourceCount": 3,
      "connectedSourceCount": 1
    }
  ],
  "total": 1,
  "hasMore": false,
  "nextOffset": null
}
FieldTypeNotes
itemsarrayStorefront summary rows
items[].idintegerStorefront ID
items[].platformIdstringPublic-facing slug
items[].namestringStorefront display name
items[].publisherDomainstring | nullPublisher domain
items[].displayStatusenumconfiguring, transacting, archived
items[].adapterProviderTypestring | nullAdapter platform (e.g. meta), null for non-adapter
items[].supportedCampaignTypesarrayDECISIONED and/or ROUTED
items[].channels / regionsarraySupported channels and covered regions
items[].sourceCountintegerTotal inventory sources
items[].connectedSourceCountintegerSources the buyer already has working credentials for
totalintegerTotal matching storefronts
hasMorebooleanWhether more pages exist
nextOffsetinteger | nullOffset 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

Sources + connection state

Storefront object guide

Full model: sources, OAuth, seller side