Per-SKU object
| Field | Type | Description |
|---|---|---|
sku | string | Product SKU |
immediate_inventory | object | Sellable quantity right now, by region |
future_inventory | object | Incoming PO quantity by region and ETA |
refreshed_at | string (ISO 8601) | When this row was last computed |
immediate_inventory
| Key | Meaning |
|---|---|
usa | Units sellable now for USD orders |
canada | Units sellable now for CAD orders |
0 in one region while still having future incoming quantity.
future_inventory
Each region contains an array of ETA lines, sorted by expected_date ascending:
| Field | Meaning |
|---|---|
expected_date | Arrival date (YYYY-MM-DD). null when no ETA is on file (sorted last) |
quantity | Uncommitted incoming units expected on that date |
Regional mapping
| Order currency | API region key |
|---|---|
| USD | usa |
| CAD | canada |
Data freshness
refreshed_at is updated when inventory is recomputed (warehouse syncs, order transforms, and a nightly full refresh). Treat it as a freshness indicator, not a cache TTL — poll at the rate your integration requires.