Skip to main content
GET /api/v2/buyer/storefronts/credentials Lists all credentials the buyer has registered, each scoped to the storefront sources it gives access to. Use it to build a single “connected sources” view without paging through each storefront.

​
Request

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

​
Parameters

None.

​
Response

[
  {
    "id": "722",
    "accountIdentifier": "acme-brand-account",
    "accountType": "CLIENT",
    "status": "ACTIVE",
    "registeredBy": "user@acme.com",
    "createdAt": "2026-02-23T19:55:11.602Z",
    "updatedAt": "2026-02-23T19:56:56.272Z",
    "sources": [
      {
        "storefrontId": 42,
        "storefrontName": "Premium CTV Storefront",
        "sourceId": "src_main",
        "sourceName": "Premium CTV — Direct"
      }
    ]
  }
]
FieldTypeNotes
idstringCredential record ID
accountIdentifierstringThe buyer’s account identifier at the source
accountTypestringAccount type (e.g. CLIENT, MARKETPLACE)
statusstringCredential status (e.g. ACTIVE)
registeredBystring | nullWho registered the credential; null on legacy rows
createdAt / updatedAtstringISO 8601 timestamps
sourcesarray(storefrontId, sourceId) pairs this credential covers. May be empty for orphaned credentials whose source is no longer linked
sources[].storefrontIdintegerStorefront the credential covers
sources[].sourceIdstringInventory source within the storefront
sources[].storefrontName / sourceNamestringDisplay names

​
Errors

  • 401 UNAUTHORIZED — missing or invalid bearer token.
See Errors for the full error contract.

Storefront tasks

All storefront operations

Register source credentials

Connect a source

Get storefront

Sources + connection state