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

FieldTypeRequiredNotes
sourceIdstring (path)YesStorefront-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