> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List credentials

> List every credential you've registered across storefront sources

`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

```bash curl theme={null}
curl https://api.interchange.io/api/v2/buyer/storefronts/credentials \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

None.

## Response

```json theme={null}
[
  {
    "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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Storefront tasks" href="/v2/buyer/storefronts/tasks" icon="list-check">
    All storefront operations
  </Card>

  <Card title="Register source credentials" href="/v2/buyer/storefronts/tasks/register-source-credentials" icon="user-lock">
    Connect a source
  </Card>

  <Card title="Get storefront" href="/v2/buyer/storefronts/tasks/get-storefront" icon="magnifying-glass">
    Sources + connection state
  </Card>
</CardGroup>