Get single item inventory by ship node

Call this endpoint when you need to see the inventory counts for a specific SKU based on a ship node. Including a ship node in your request returns data for that location only. Omitting a ship node returns inventory counts for all ship nodes where the SKU is stocked. Use this endpoint to verify stock levels or troubleshoot a single product.

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

Endpoint

GET https://marketplace.walmartapis.com/v3/inventories/{sku}

Sample request

This sample demonstrates how to retrieve the inventory for a SKU. The URL parameter identifies the SKU, and you may add the optional shipNode query parameter to filter for a specific fulfillment center.

For more details and optional parameters, refer to the API reference.

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

import requests sku = "SKU_0001" # Replace with your actual SKU
url = f"https://marketplace.walmartapis.com/v3/inventories/{sku}" headers = { "Authorization": "Basic <Base64EncodedConsumerKey:ConsumerSecret>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "0123456789", "Accept": "application/json", "Content-Type": "application/json"
} response = requests.get(url, headers=headers)
print("Status code:", response.status_code)
print("Response JSON:", response.json()) 

Modify your code

1. Replace SKU_0001 with your actual SKU.
2. Update the Authorization header with your Base64-encoded client ID and client secret pair.
3. Use your unique WM_QOS.CORRELATION_ID for each request.
4. Optionally, add the shipNode query parameter if you wish to restrict the result to a specific node.

Sample response

{ "sku": "SKU_0001", "nodes": [ { "shipNode": "NODE_0001", "status": "Success" }, { "shipNode": "NODE_0002", "status": "Failed", "errors": [ { "code": "404.CONTENT_NOT_FOUND", "field": "shipNode", "description": "The system could not find the shipNode provided in the request. Please verify that the shipNode value is correct and try again.", "info": "Requested content could not be found.", "severity": "INFO", "category": "APPLICATION", "errorIdentifiers": { "entry": [] } } ] } ]
} 

Result

If successful, the API returns an HTTP status 200 OK with a JSON response that includes the SKU and a number of nodes. Each node shows the inventory details, with the status indicating "Success" or "Failed" (including error details, if applicable).

Next steps

Update the inventory for a given ship node.