Skip to main content
GET
/
inventory-sources
/
{sourceId}
/
status
Get ad-server source status
curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/inventory-sources/{sourceId}/status \
  --header 'Authorization: Bearer <token>'
{
  "operational": {
    "isLive": true,
    "discoveryDegraded": true,
    "deliveryDegraded": true,
    "summary": "<string>",
    "issues": [
      {
        "code": "<string>",
        "message": "<string>",
        "affects": []
      }
    ]
  },
  "adapter": {
    "type": "<string>",
    "connected": true,
    "lastTestedAt": "2023-11-07T05:31:56Z",
    "lastTestError": "<string>"
  },
  "syncs": {
    "inventory": {
      "status": "<string>",
      "severity": "ok",
      "lastSuccessAt": null,
      "issue": null,
      "lastRunAt": null,
      "itemCount": null,
      "error": null
    },
    "customTargeting": {
      "status": "<string>",
      "severity": "ok",
      "lastSuccessAt": null,
      "issue": null,
      "lastRunAt": null,
      "itemCount": null,
      "error": null
    },
    "advertisers": {
      "status": "<string>",
      "severity": "ok",
      "lastSuccessAt": null,
      "issue": null,
      "lastRunAt": null,
      "itemCount": null,
      "error": null
    },
    "reporting": {
      "status": "<string>",
      "severity": "ok",
      "lastSuccessAt": null,
      "issue": null,
      "lastRunAt": null,
      "itemCount": null,
      "error": null
    },
    "signalCoverage": {
      "status": "<string>",
      "severity": "ok",
      "lastSuccessAt": null,
      "issue": null,
      "lastRunAt": null,
      "itemCount": null,
      "error": null
    },
    "pricingAvailability": {
      "status": "<string>",
      "severity": "ok",
      "lastSuccessAt": null,
      "issue": null,
      "lastRunAt": null,
      "itemCount": null,
      "error": null
    }
  },
  "workflows": {
    "openCount": 0,
    "oldestOpenedAt": "2023-11-07T05:31:56Z",
    "byKind": {}
  },
  "packages": {
    "activeCount": 0,
    "pausedCount": 0,
    "last24hImpressions": 0
  },
  "creatives": {
    "activeCount": 0,
    "pendingReviewCount": 0,
    "rejectedLast24hCount": 0
  },
  "webhooks": {
    "last24h": {
      "delivered": 0,
      "failed": 0,
      "successRate": 123
    },
    "lastFailureAt": "2023-11-07T05:31:56Z"
  },
  "fetchedAt": "2023-11-07T05:31:56Z",
  "products": {
    "activeCount": 0,
    "draftCount": 0,
    "archivedCount": 0
  },
  "inventoryProfiles": {
    "totalCount": 0,
    "completeCount": 0,
    "incompleteCount": 0,
    "wholesaleOwnedCount": 0
  },
  "setupTasks": {
    "blockerCount": 0,
    "warningCount": 0,
    "items": [
      {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "isComplete": true,
        "configurePath": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

API key or access token

Path Parameters

​
sourceId
string
required

Inventory source ID

Minimum string length: 1

Response

Get ad-server source status

Operational snapshot of a managed ad-server source: adapter health, sync state, workflows, packages, creatives, webhook stats.

​
operational
object
required

Derived private uptime-style state for a managed ad-server source. Local provisioning state is lifecycle bookkeeping; this status is computed from upstream status at read time.

​
adapter
object
required
​
syncs
object
required
​
workflows
object
required
​
packages
object
required
​
creatives
object
required
​
webhooks
object
required
​
fetchedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
​
products
object

Sellable wholesale-product rollup. Optional for backward compatibility with upstream builds before the rollup shipped.

​
inventoryProfiles
object

Reusable inventory-profile ingredient rollup from the managed source. Separate from products, which counts sellable wholesale products.

​
setupTasks
object

Configuration-completeness rollup from the upstream managed-source status. Storefront merges these with its own platform-managed task list.