List credentials

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

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.apostra.com/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"
      }
    ]
  }
]

Field	Type	Notes
`id`	string	Credential record ID
`accountIdentifier`	string	The buyer’s account identifier at the source
`accountType`	string	Account type (e.g. `CLIENT`, `MARKETPLACE`)
`status`	string	Credential status (e.g. `ACTIVE`)
`registeredBy`	string \| null	Who registered the credential; `null` on legacy rows
`createdAt` / `updatedAt`	string	ISO 8601 timestamps
`sources`	array	`(storefrontId, sourceId)` pairs this credential covers. May be empty for orphaned credentials whose source is no longer linked
`sources[].storefrontId`	integer	Storefront the credential covers
`sources[].sourceId`	string	Inventory source within the storefront
`sources[].storefrontName` / `sourceName`	string	Display 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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

List credentials

Request

Parameters

Response

Errors

Storefront tasks

Register source credentials

Get storefront

​Request

​Parameters

​Response

​Errors

​Related

Storefront tasks

Register source credentials

Get storefront

Request

Parameters

Response

Errors

Related