Item management API requests

This table shows how the Item management API requests tie into the steps outlined in the overview workflow diagram, a short description of the API, call type, communication type, link to the API reference, and the API throttling limits.

These endpoints are throttled—if you submit too many feeds too quickly, you might hit Walmart’s rate limits and receive HTTP 429 responses. To learn more about throttling, refer to the Marketplace throttling documentation.

Overview StepRequestDescriptionCall TypeTypeMarkets
1Get Spec APIRequest item setup requirements for up to 20 product typesPOSTSyncUS only
2Taxonomy APIGet hierarchy of Product Types needed for Item Setup and MaintenanceGETSyncUS only
1a
and
4
Get Items Count by Status APIRetrieve the total number of items filtered by a specific status, such as PUBLISHED or UNPUBLISHEDGETSyncGlobal
1a
and
4
Catalog Search APISearch your catalog with attributes like price, listing status, and rating along with support for wildcard queriesPOSTSyncGlobal
1a
and
4
Get Item Associations APIRetrieve shipping templates and fulfillment centers associated with your item SKUsPOSTSyncGlobal
1a
and
4
Item Search APIQuery the Walmart.com global product catalog by item keyword, UPC or GTINGETSyncGlobal
1a
and
4
Get Item Count by Groups APICount items that share a common variant IDGETSyncGlobal
2Bulk Item Setup APIAdd or update items in bulk for any item spec versionsPOSTAsyncGlobal
GTIN Exemption StatusFilter and view the status of GTIN exemption submissionsGETSyncUS only
2aRetire an Item APIRetire an item identified by its SKUDELETESyncGlobal
3All feed statuses APIReturns the feed statuses for all the specified Feed IDsGETSyncGlobal
3Feed item status APIReturns the feed and item status for a specified Feed IDGETSyncGlobal
3aHazmat items on hold APILists items that are on hold for hazmat compliance review. This is a WFS Only functionPOSTSyncGlobal
1a
and
4
All Items APIDisplays a list of all items by using either nextCursor or offset and limit query parametersGETSyncGlobal
1a
and
4
An item APIRetrieves an item and displays the item detailsGETSyncGlobal