> ## 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 ad-server source status

> Fetch the operational snapshot for an ad-server-backed inventory source

`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

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.interchange.io/api/v2/storefront/inventory-sources/retail-gam/status \
    -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}
{
  "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](/v2/storefront/inventory-sources/tasks/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](/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="Get ad-server connection" href="/v2/storefront/inventory-sources/tasks/get-ad-server-connection" icon="server">
    Connection state
  </Card>

  <Card title="List sync history" href="/v2/storefront/inventory-sources/tasks/list-sync-history" icon="clock-rotate-left">
    Per-run sync drill-down
  </Card>

  <Card title="Refresh" href="/v2/storefront/inventory-sources/tasks/refresh" icon="arrows-rotate">
    Force-refresh the cache
  </Card>
</CardGroup>
