The DC Inventory API provides suppliers with near real-time visibility of available inventory at our Walmart Distribution Centers (DCs). Suppliers can use this endpoint to request inventory status information for up to 100 items.

Endpoints

POST

/dc/inventory/status?itemIdentifier=wmItemNbr

Optional Headers

The following optional header keys are available:

Name	Description	Required	Data Type
wm_context_identifier	A Walmart Supplier's unique identifier.	Mandatory for Preferred Service Providers (PSPs) only.	String

Request Body Details

Parameter	Description	Data Type
dcNbr	The valid DC number associated with the requested details.	Integer
values	An array containing the Walmart Item Numbers (wmItemNbr) that uniquely identify the items. A maximum of 100 values can be passed.	Array

Response Details

Parameter	Description	Data Type
supplier	The name of the supplier.	String
dcNbr	The DC number(s) associated with the requested details.	Integer
inventory	The array that will contain the list of items identified and their inventory, by type.	Array
wmItemNbr	The Walmart Item Number that uniquely identifies the items.	String
inventoryType	The type of inventory (ie, promotional inventory as "promo" and regular inventory as "turn").	String
state	The status of the inventory (ie, available). See Inventory States below for more information.	String
quantity	The number of items that are currently available at DC level.	Double
lastUpdatedTime	Latest time when the data was updated. Timestamp is specified in ISO format (YYYY-MM-DDTHH24:MM:SS), in UTC timezone.	Date
qtyUom	The quantity unit of measure. Example: EA (eaches)	String
errors	The array that will contain the list of values with their corresponding error message and Tmestamp.	Array

Inventory States

Parameter	Description
ONORDER	A PO has been created by OMS to meet inventory demand.
AVAILABLE	Inventory that is available at the DC.
HOLD	Inventory that has been placed on hold in the DC due to damage or expiration.
WIP	Indicates items that are in progress (not yet ready). For example, bananas that are waiting to ripen.
REQUESTED	Inventory that has been requested for a store from the DC.
ALLOCATED	Inventory at the DC that has been allocated for a replenishment order.
PICKED	Inventory at the DC that has been picked for a particluar store.
INTRANSIT	Inventory that has been shipped from one DC to another DC.