Get WFS inventory

If you use Walmart Fulfillment Services (WFS), this endpoint retrieves inventory for items fulfilled by Walmart’s warehouses. Learn more about WFS by referring to the Walmart WFS guide.

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/fulfillment/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.

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": "ABC123,DEF789"). The WFS Get Inventory API has a limit of 10 SKUs per request, specifically applicable for multichannel inventory management.
4. This endpoint might return a different structure (wfsItems instead of items). Make sure your code correctly parses each field (like status, available, and reserved).

Sample response

{ "headers": { "totalCount": 0, "limit": 0, "offset": 0 }, "payload": { "inventory": [ { "sku": "string", "shipNodes": [ { "modifiedDate": "string", "availToSellQty": 0, "onHandQty": 0, "shipNodeType": "string" } ] } ] }
}

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.

See also

Learn more about managing WFS inventory on Marketplace Learn.