Skip to main content

Get Faire Inventory Summary (Legacy)

GET 
/api/faire/inventory/summary

Legacy — prefer the per-instance route GET /api/faire/instances/{integrationInstance}/inventory/summary.

Aggregate inventory comparison metrics for a Faire integration instance (total tracked items, count in-sync with Faire, count needing an update, count never fetched).

Tenant resolution (multi-instance safety): Both shapes are accepted, in priority order:

  • filter[integration_instance_ids] (preferred, Amazon-unified plural form; comma-separated CSV — first ID wins)
  • filter[instance_id] (legacy singular)
  • ?instance_id= query string fallback
  • body instance_id (POST/PUT only)

If none resolve to an existing FaireIntegrationInstance the endpoint returns an empty/zeroed payload — it does NOT silently fall back to the first tenant's data.

Zeroed response when no instance resolves:

{
  "data": {
    "total_items": 0,
    "in_sync": 0,
    "needs_update": 0,
    "never_fetched": 0
  }
}

Request​

Responses​

Successful response