List sync history

GET /api/v2/storefront/inventory-sources/{sourceId}/sync-history Returns the timeline of sync runs for an ad-server-backed source. Use this to drill into individual runs after reading the coarse sync blocks on the status snapshot.

Request

curl "https://api.interchange.io/api/v2/storefront/inventory-sources/retail-gam/sync-history?syncType=inventory&limit=50" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`sourceId`	string (path)	Yes	Storefront-scoped inventory source ID
`syncType`	string (query)	No	Filter by sync type (e.g. `inventory`)
`status`	string (query)	No	Filter by run status
`limit`	integer (query)	No	1–500
`cursor`	string (query)	No	Pagination cursor from a prior `nextCursor`

Response

{
  "runs": [
    {
      "syncId": "sync_01J2",
      "syncType": "inventory",
      "startedAt": "2026-05-02T08:00:00Z",
      "completedAt": "2026-05-02T08:03:00Z",
      "status": "success",
      "durationSeconds": 180,
      "itemsProcessed": 1840,
      "itemsFailed": 0,
      "errorSummary": null,
      "errorCategory": null
    }
  ],
  "count": 1,
  "nextCursor": null
}

When nextCursor is non-null, pass it back as the cursor parameter to walk pages.

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 status

Coarse sync rollups

Refresh

Force a fresh sync snapshot

Get ad-server connection

Connection state

List inventory sources Author property and tag mappings

⌘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

Request

Parameters

Response

Errors

Inventory source tasks

Get status

Refresh

Get ad-server connection

​Request

​Parameters

​Response

​Errors

​Related

Inventory source tasks

Get status

Refresh

Get ad-server connection

Request

Parameters

Response

Errors

Related