Skip to main content
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

curl https://api.interchange.io/api/v2/storefront/inventory-sources \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

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

​
Response

Pagination totals are available in the meta.pagination object (offset-based: skip, take, total, hasMore) — see Pagination. 
[
  {
    "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 for the full error contract.

Inventory source tasks

All operations

Inventory sources overview

Concepts and lifecycle

Create inventory source

Register a new source

Get inventory source

Read one source by ID