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

> Read a single inventory source by its source ID

`GET /api/v2/storefront/inventory-sources/{sourceId}`

Returns one inventory source with its full state, including the `managedSa` block for ad-server-backed sources and the `linkedStorefront` block for linked storefronts.

## Request

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

## Parameters

| Field      | Type          | Required | Notes                                 |
| ---------- | ------------- | -------- | ------------------------------------- |
| `sourceId` | string (path) | Yes      | Storefront-scoped inventory source ID |

## Response

```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,
  "reportingType": "WEBHOOK",
  "isAdapterSource": false,
  "createdAt": "2026-04-25T12:05:00Z",
  "updatedAt": "2026-04-25T12:05:00Z"
}
```

For a `MANAGED_SALES_AGENT` source the response carries a `managedSa` object (`connectionId`, `tenantId`, `adServer`, `lastErrorCode`, `lastError`, `deactivatedAt`, timestamps). For a `LINKED_STOREFRONT` source it carries a `linkedStorefront` object. `reportingType` (`WEBHOOK`, `BUCKET`, `POLLING`) and `reportingPollingCadence` (`DAILY`, `MONTHLY`) are null for non-`AGENT` sources.

## Errors

* `401 UNAUTHORIZED` — missing or invalid API key.
* `404 NOT_FOUND` — no source with this `sourceId` on your storefront.

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="Update inventory source" href="/v2/storefront/inventory-sources/tasks/update-inventory-source" icon="pen">
    Change fields or rotate auth
  </Card>

  <Card title="Get ad-server connection" href="/v2/storefront/inventory-sources/tasks/get-ad-server-connection" icon="server">
    Managed-source connection state
  </Card>
</CardGroup>