> ## 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.

# Get storefront

> Get a single storefront with your rolled-up connection status

`GET /api/v2/buyer/storefronts/{storefrontId}`

Returns a single storefront with rolled-up connection state: `connected`, `requiresCredentials`, and your registered `customerAccounts`. Use it to check fresh storefront state — for example, after registering credentials or completing an OAuth flow. Use the capabilities endpoint when you need source-level diagnostic rows.

## Request

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

## Parameters

| Field          | In   | Type    | Required | Notes                  |
| -------------- | ---- | ------- | -------- | ---------------------- |
| `storefrontId` | path | integer | Yes      | Storefront ID to fetch |

## Response

```json theme={null}
{
  "id": 42,
  "platformId": "premium-ctv",
  "name": "Premium CTV Storefront",
  "publisherDomain": "premium-ctv.example.com",
  "displayStatus": "transacting",
  "channels": ["CTV", "display"],
  "adapterProviderType": null,
  "supportedRoutingTypes": ["DECISIONED", "ROUTED"],
  "regions": ["US", "EMEA"],
  "connected": false,
  "requiresCredentials": true,
  "customerAccounts": [
    {
      "accountIdentifier": "buyer-seat-123",
      "status": "ACTIVE"
    }
  ],
  "adcpCapabilities": null
}
```

| Field                   | Type           | Notes                                                                              |
| ----------------------- | -------------- | ---------------------------------------------------------------------------------- |
| `id`                    | integer        | Storefront ID                                                                      |
| `platformId`            | string         | Public-facing slug                                                                 |
| `name`                  | string         | Storefront display name                                                            |
| `publisherDomain`       | string \| null | Publisher domain                                                                   |
| `displayStatus`         | enum           | `configuring`, `transacting`, `archived`                                           |
| `channels` / `regions`  | array          | Supported channels and covered regions                                             |
| `adapterProviderType`   | string \| null | Adapter platform, `null` for non-adapter                                           |
| `supportedRoutingTypes` | array          | `DECISIONED` and/or `ROUTED`                                                       |
| `connected`             | boolean        | Whether the buyer has the required credentials/account setup to use the storefront |
| `requiresCredentials`   | boolean        | Whether any source behind the storefront requires buyer credentials                |
| `customerAccounts`      | array          | Registered buyer accounts, deduped across the storefront                           |
| `adcpCapabilities`      | object \| null | Rolled-up capability manifest when cached capability data exists                   |

## Errors

* `401 UNAUTHORIZED` — missing or invalid bearer token.
* `404 NOT_FOUND` — the storefront does not exist or is not visible to the caller.

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 that requires credentials
  </Card>

  <Card title="List storefronts" href="/v2/buyer/storefronts/tasks/list-storefronts" icon="list">
    Paginated summaries
  </Card>

  <Card title="Get storefront capabilities" href="/v2/buyer/storefronts/tasks/get-storefront-capabilities" icon="signal">
    Source-level capability diagnostics
  </Card>
</CardGroup>