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

Replace SKU_0001 with your actual SKU.
Update the Authorization header with your Base64-encoded client ID and client secret pair.
Use your unique WM_QOS.CORRELATION_ID for each request.
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.

Updated 3 months ago

Did this page help you?