List WFS Inventory
GET/api/walmart/:id/wfs/inventory
Paginated WFS inventory snapshot for a Walmart integration instance. Quantities are pulled from Walmart and are read-only (Walmart owns the stock). A row's ship_node is the fulfillment centre holding the stock, or null when Walmart reports the SKU across the seller's whole WFS network rather than per centre.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
inbound_quantity is Walmart's own count of units on their way. Each row also carries a breakdown of that figure: open_inbound_shipments lists the inbound shipments still counted by Walmart (created through receiving; cancelled, received and closed shipments are excluded) with the units for this SKU, the shipment status, its expected and actual delivery dates, how many days it has been open and an overdue flag (past its latest expected delivery with no delivery reported). in_flight_units is the sum of those units, and inbound_mismatch is true when it disagrees with inbound_quantity, meaning a booking exists on one side only. A per-centre row only counts shipments bound for that centre. Requires a Bearer token.
Abandoned shipments. inbound_quantity is Walmart's own count and keeps including shipments the seller marked abandoned in SKU.io (Walmart cannot close a never-tendered shipment once its cancel window passes). abandoned_inbound_units is the number of those units, effective_inbound_quantity is Walmart's count net of them, and abandoned_inbound_shipments lists the shipments behind them. inbound_mismatch compares SKU.io's open shipments against effective_inbound_quantity.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.