Item Management API: Overview
The item is the basic building block for all operations for Walmart suppliers. The requests in the Item Management API enable suppliers to set up and manage items. Items can be set up for Walmart to place purchase orders. Items must then be published for customers to see and purchase the items on Walmart.com.
An item that has been set up means Walmart systems have successfully processed and created the item submission. An item setup or maintenance submission uses Walmart’s async POST feed requests. Reference the following question-and-answer format for more information.
- What is the item submission service level agreement (SLA)? An item bulk submission process takes up to four hours.
- Are there any exceptions to the SLA? Item submissions can go into a manual Walmart associate review process. This review process is noted in the feed status response. The SLA for this review varies from one day to one week.
- How long does it take for items to be visible in Walmart's catalog or on Walmart.com? There is an SLA of up to six hours between when an item is successfully submitted and when the data is available.
Once an item submission (setup or maintenance) is defined as successful in the feed status, the supplier can view the item or the changes in Walmart's catalog with the item read requests (GET Retrieve a single item (v3), GET Retrieve a single item (v4), or GET Retrieve all items).
An item is published once all necessary attributes are confirmed and when all required Walmart systems have processed the item. This process typically takes several hours after an item is set up, and no supplier action is needed. A supplier can check the publish status of an item in the item read requests (GET Retrieve a single item (v3), GET Retrieve a single item (v4), or GET Retrieve all items).
We recommend suppliers also set up a monitoring process to ensure their items are pushed to Walmart.com.
Reference the following flow diagram for an overview of the item management process.

To learn more about item setup and maintenance, access training courses or knowledge base articles.
Item Management Requests Available
Walmart offers several requests in the Item Management API, detailed in the following table:
Request | Call Type | Description | Type |
---|---|---|---|
Expose product type taxonomy | GET | View Walmart's product type classification to determine how to set up or maintain items. | Sync |
Maintain items in bulk | POST | Set up and maintain items by product type in bulk by product type (current) or category (legacy) | Async |
Add rich media | POST | Update rich media (videos, comparison tables, and view 360 media) for items. | Async |
Retrieve all items | GET | Retrieve all items in the supplier's catalog | Sync |
Retrieve a single item | GET | Enable a supplier to search for a specific item and retrieve all of its information | Sync |
Updated about 17 hours ago