> ## 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 inventory sources

> List every inventory source on the storefront

`GET /api/v2/storefront/inventory-sources`

Returns every inventory source on your storefront — external agents, ad-server-backed sources, linked storefronts, and modular sources — as an array of source resources.

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.interchange.io/api/v2/storefront/inventory-sources \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

This endpoint takes no path, query, or body parameters. The storefront is resolved from your API key's account context.

## Response

Pagination totals are available in the `meta.pagination` object (offset-based: `skip`, `take`, `total`, `hasMore`) — see [Pagination](/v2/reference/pagination).

```json theme={null}
[
  {
    "id": "900123456789",
    "sourceId": "retail-network-agent",
    "name": "Retail Network Agent",
    "executionType": "AGENT",
    "status": "ACTIVE",
    "agentId": "agent_01HX...",
    "type": "SALES",
    "endpointUrl": "https://agent.retail-network.example.com/mcp",
    "protocol": "MCP",
    "authenticationType": "API_KEY",
    "authConfigured": true,
    "isAdapterSource": false,
    "createdAt": "2026-04-25T12:05:00Z",
    "updatedAt": "2026-04-25T12:05:00Z"
  }
]
```

Each item is an `InventorySourceResponse`. `executionType` distinguishes the kind of source: `AGENT`, `MANAGED_SALES_AGENT` (carries a `managedSa` block), `LINKED_STOREFRONT` (carries a `linkedStorefront` block), or `MODULAR_SOURCE`. Credentials are never returned — `authConfigured` reports whether auth is set.

## Errors

* `400 VALIDATION_ERROR` — malformed request.
* `401 UNAUTHORIZED` — missing or invalid API key.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Inventory source tasks" href="/v2/storefront/inventory-sources/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="Inventory sources overview" href="/v2/storefront/inventory-sources/overview" icon="plug">
    Concepts and lifecycle
  </Card>

  <Card title="Create inventory source" href="/v2/storefront/inventory-sources/tasks/create-inventory-source" icon="plus">
    Register a new source
  </Card>

  <Card title="Get inventory source" href="/v2/storefront/inventory-sources/tasks/get-inventory-source" icon="magnifying-glass">
    Read one source by ID
  </Card>
</CardGroup>