Get ad-server source status

GET /api/v2/storefront/inventory-sources/{sourceId}/status Returns the upstream managed-source operational snapshot: derived health, adapter connectivity, sync state, workflows, packages, creatives, webhook stats, and setup tasks.

Request

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

Parameters

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

Response

{
  "operational": {
    "isLive": true,
    "discoveryDegraded": false,
    "deliveryDegraded": false,
    "summary": "Source is live and serving discovery.",
    "issues": []
  },
  "adapter": {
    "type": "google_ad_manager",
    "connected": true,
    "lastTestedAt": "2026-05-02T09:14:00Z",
    "lastTestError": null
  },
  "syncs": {
    "inventory": {
      "status": "success",
      "severity": "ok",
      "lastSuccessAt": "2026-05-02T08:03:00Z",
      "issue": null,
      "lastRunAt": "2026-05-02T08:00:00Z",
      "itemCount": 1840,
      "error": null
    }
  },
  "fetchedAt": "2026-05-02T09:20:00Z"
}

operational is the derived health rollup: isLive, discoveryDegraded, deliveryDegraded, a summary string, and an issues[] array (each issue carries code, severity of warning/critical, message, and affects[] of discovery/delivery/setup). The full response also includes workflows, packages, creatives, webhooks, and setupTasks blocks. These are coarse rollups — use List sync history for per-run drill-down.

Errors

401 UNAUTHORIZED — missing or invalid API key.
404 NOT_FOUND — no ad-server-backed source with this sourceId.

See Errors for the full error contract.

Inventory source tasks

All operations

Get ad-server connection

Connection state

List sync history

Per-run sync drill-down

Refresh

Force-refresh the cache

Get modular readiness Launch admin UI

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Get ad-server source status

Request

Parameters

Response

Errors

Inventory source tasks

Get ad-server connection

List sync history

Refresh

​Request

​Parameters

​Response

​Errors

​Related

Inventory source tasks

Get ad-server connection

List sync history

Refresh

Request

Parameters

Response

Errors

Related