All items

get

https://marketplace.walmartapis.com/v3/items

Use this API endpoint to retrieve all items from a partner’s catalog. It supports pagination using nextCursor or offset and limit. Each item response includes an isDuplicate field that shows whether it’s a duplicate. To get more details about duplicate items, include the optional showDuplicateItemInfo parameter. This adds a destinationItem property with relevant information.

You can also include the optional includeCustomerFavoritesStatus parameter to return an isCustomerFavorite flag, which shows if an item is popular with customers.

To retrieve all items in a variant group, pass variantGroupId as a query parameter. Each item in the response includes variantGroupId. When available, the variantGroupInfo object includes:

isPrimary: Whether the item is the primary/hero variant shown in search.
groupingAttributes: Attribute name/value pairs (for example, color and size) that define the item's variation within the group.

Throttling:
For details on throttling, refer to the Walmart throttling documentation

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

nextCursor

string

Defaults to *

When more than 200 items are retrieved, use nextCursor for pagination. The cursor remains the same across all page requests and is valid for 2 minutes. If the cursor expires, the API returns a 400 Invalid Cursor error.

sku

string

Stock Keeping Unit is an arbitrary alphanumeric unique ID specified by the seller. This is used to identify an item.

gtin

string

Global Trade Item Number is a unique identifier for a product that is recognized internationally. This must be 14 digits.

offset

string

Defaults to 0

Zero-based index of the first entity to return (starting position of the page). Defaults to 0, must be ≤ 10,000. For large result sets, paginate using nextCursor.

limit

string

Defaults to 20

The number of entities to be returned per request. Defaults to 20, cannot be more than 1000 entities per request.

lifecycleStatus

string

enum

The status of an item in the overall lifecycle.

Allowed:

publishedStatus

string

enum

The status of an item in the submission process.

Allowed:

variantGroupId

string

Filter items by variant group ID. Returns all items that share this variantGroupId.

condition

string

enum

The condition of a product.

availability

string

enum

The availability of a product.

Allowed:

showDuplicateItemInfo

boolean

enum

Indicates whether to include details of duplicate items in the response. Set this parameter to true if you want to receive information on duplicate items.

Allowed:

includeCustomerFavoritesStatus

boolean

enum

Set to true to include isCustomerFavorite item details in the response.

Allowed:

Headers

WM_SEC.ACCESS_TOKEN

string

required

Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.

WM_CONSUMER.CHANNEL.TYPE

string

A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.

WM_QOS.CORRELATION_ID

string

required

A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.

WM_SVC.NAME

string

required

Walmart Specifies the name of the Walmart service being called.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Successful Operation

400Bad Request

500Internal Server Error