Guides
My Account

WFS Get Inventory (New)

The WFS Inventory API provides real-time inventory data for items fulfilled through Walmart Fulfillment Services (WFS). This API allows you to monitor stock availability, retrieve detailed inventory information, including stock status, item lifecycle status, and inventory age. By querying for specific SKUs, you can access a wide range of inventory metrics, to ensure optimal stock management, streamline operations, and make informed decisions about your WFS inventory. Learn more about WFS by referring to the Walmart WFS guide and managing WFS inventory.

Note: This page describes an example using only the required parameters and inputs for getting WFS inventory. For a full list of customization options and additional capabilities, refer to the Walmart Inventory API Reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/wfs/inventory

Sample request

This sample request retrieves WFS inventory without filtering by SKU. This example shows how to call the API using the required headers. Upon sending the request, the response JSON response will contain the inventory data for the specified SKU.

curl -X GET "https://marketplace.walmartapis.com/v3/fulfillment/inventory" \ -H "Authorization: Basic <Base64EncodedConsumerKey:ConsumerSecret>" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_QOS.CORRELATION_ID: 1234567890" \ -H "Accept: application/json" \ -H "Content-Type: application/json"

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/inventory" headers = { "Authorization": "Basic <Base64EncodedConsumerKey:ConsumerSecret>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "1234567890", "Accept": "application/json", "Content-Type": "application/json"
} # Optional: add query parameters to filter by SKU if supported
params = { # "sku": "SKU123,SKU456"
} response = requests.get(url, headers=headers, params=params)
print("Status Code:", response.status_code)
print("Response JSON:", response.json())

Modify your code

  1. Replace <Base64EncodedConsumerKey:ConsumerSecret> with your seller credentials.
  2. Use your unique WM_QOS.CORRELATION_ID for each request.
  3. If you want to retrieve inventory only for specific SKUs, add them in params (for example, "sku": "UPDI-WFS-HRM639993"). The WFS Get Inventory API has a limit of 10 SKUs per request.

Sample response

This sample response shows basic inventory details for a single WFS item, including identifiers (GTIN, SKU, item ID), availability (in-stock quantity), and inventory status (new, active, no reserved or inbound units). All units are within the 0–90 day inventory age, with a sell-through rate and estimated days of supply provided. Use this data to monitor item availability and performance.

{ "status": "OK", "headers": { "offset": 0, "limit": 2, "totalCount": 2568 }, "payload": { "inventory": [ { "itemInformation": { "itemName": "Football t-shirt, Black", "gtin": "00812330020121", "sku": "FTB-TS292B", "itemID": "44362711", "offerID": "C4DCEDBE5787475997A7E5ED43B62B7E", "brand": "Walmart", "itemCondition": "New" }, "inventoryData": { "publishingStatus": "Published", "itemLifecycle": "Active", "stockStatus": "In Stock", "availableUnits": 50, "reservedUnits": 22, "inboundUnits": 11, "unavailableUnits": { "inventoryReviewUnits": 10, "inventoryMovementUnits": 20 }, "onhandUnits": 102, "inventoryAge": { "0To90days": 10, "91To180days": 20, "181To270days": 50, "271To365days": 3, "365PlusDays": 5 }, "firstInStockDate": "2020-04-23" }, "inventoryInsights": { "salesForecastWeek1to4": 15, "salesForecastWeek5to8": 12, "salesForecastWeek9to12": null, "sellThroughRate": 2.5, "daysOfSupply": "0", "outOfStockDate": "2024-02-24", "suggestedUnits": 25, "surplusUnits": 0 } }, { "itemInformation": { "itemName": "Football t-shirt in White", "gtin": "00812330023344", "sku": "FTB-TS265", "itemID": "965295116", "offerID": "5C545B570A2F491FA6AFDCB50ABA0C11", "brand": "Walmart", "itemCondition": "Used" }, "inventoryData": { "publishingStatus": "Published", "itemLifecycle": "Active", "stockStatus": "Out of Stock", "availableUnits": 0, "reservedUnits": 0, "inboundUnits": 0, "unavailableUnits": { "inventoryReviewUnits": 0, "inventoryMovementUnits": 0 }, "onhandUnits": 0, "inventoryAge": { "0To90days": 0, "91To180days": 0, "181To270days": 0, "271To365days": 0, "365PlusDays": 0 }, "firstInStockDate": "2020-07-31" }, "inventoryInsights": { "salesForecastWeek1to4": 5, "salesForecastWeek5to8": 10, "salesForecastWeek9to12": null, "sellThroughRate": 0.0, "daysOfSupply": "0", "outOfStockDate": "2024-02-24", "suggestedUnits": 25, "surplusUnits": 0 } } ] }
}

Result

If successful, the API returns an HTTP status: 200 OK with a JSON payload containing a headers object with the total count, limit, and offset. The payload contains an inventory array where each object lists a SKU and an array of ship node details.

Updated 1 day ago