Inventory overview

Use the Walmart Marketplace Inventory API to manage and update the on-hand inventory for items you list on Walmart.com. As a Walmart seller or solution provider, you can:

• Retrieve current inventory levels for your SKUs.
• Update item quantities by SKU and ship node.

How it works

Overall seller journey

In a common user journey, a seller or solution provider might complete the following Walmart flow:

1. Item setup: Create or register products (SKUs) with Walmart using the Item Management API.
2. Inventory management: Keep SKU quantities accurate using the Inventory API.
3. Order management: Retrieve and confirm orders, shipments, and cancellations through the Orders API.
4. Pricing: Adjust item prices through Pricing APIs.

Inventory management flow

Within inventory management, a typical flow is to view your current inventory levels and then update the inventory count as needed.

There are three endpoints for managing inventory:

1. First, use GET /cl/inventory?sku={SKU} to retrieve the current inventory count for a given SKU.
2. Then, update the inventory using one of two methods:
   1. For a single SKU update, use PUT /cl/updateinventoryforanitem
   2. For updating multiple SKUs in bulk, use POST /cl/updatebulkinventory.

This two-step process, retrieving current inventory and then applying updates, ensures that you can verify stock levels before making adjustments.

Reference guide

This guide explains how to use the Inventory API, providing practical examples and step-by-step instructions for integrating inventory management into your solution.

For full technical details, including endpoints, parameters, and brief descriptions, refer to the Walmart Inventory API reference guide.

Prerequisites

Complete the following before integrating an Inventory API:

• Complete the steps in the Getting started guide.
• OAuth authentication is required to access the Walmart Marketplace APIs. Ensure you have obtained the credentials and tokens before making API requests. For more information, refer to OAuth authorization.
• Set up and register your item SKUs with Walmart before you can manage the inventory using the Inventory API.

Commonly used terms

Market availability

The Walmart Inventory API is available for sellers listing on Walmart marketplaces in Canada, Chile, Mexico, and the U.S.

Next step

Decide which Inventory APIs to integrate.