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:

RequestCall TypeDescriptionType
Expose product type taxonomyGETView Walmart's product type classification to determine how to set up or maintain items.Sync
Maintain items in bulkPOSTSet up and maintain items by product type in bulk by product type (current) or category (legacy)Async
Add rich mediaPOSTUpdate rich media (videos, comparison tables, and view 360 media) for items.Async
Retrieve all itemsGETRetrieve all items in the supplier's catalogSync
Retrieve a single itemGETEnable a supplier to search for a specific item and retrieve all of its informationSync