All items

This API endpoint allows you to retrieve a complete list of items from a partner’s catalog, supporting pagination through nextCursor or offset and limit parameters. Each item response includes an isDuplicate field to indicate whether an item is a duplicate. You can optionally include the showDuplicateItemInfo parameter to receive additional details about duplicate items, such as a destinationItem property that provides relevant information.

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:
This endpoint is throttled at a maximum of 300 transactions per minute (TPM) per seller. When called with the showDuplicateItemInfo parameter, this is reduced to 60 TPM.


Market availability: Global

Query Params
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.

Market availability: Global

string

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

Market availability: Global

string

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

Market availability: Global

string
Defaults to 0

The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to true.

Market availability: Global

string
Defaults to 20

The number of entities to be returned. It cannot be more than 50 entities. Use it only when the includeDetails is set to true.

Market availability: Global

string
enum

The status of an item in the overall lifecycle.

Market availability: Global

Allowed:
string
enum

The status of an item in the submission process.

Market availability: Global

Allowed:
string

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

Market availability: Global

string
enum

The condition of a product.

Market availability: US only

string
enum

The availability of a product.

Market availability: US only

Allowed:
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.

Market availability: US only

Allowed:
Headers
string
required

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

Market availability: Global

string

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

Market availability: Global

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.

Market availability: Global

string
required

Specifies the name of the Walmart service being called.

Market availability: Global

string
enum
required

The target market of the API call.

Market availability: Global

Allowed:
string
enum
required

The version of the global API used.

Market availability: Global

Allowed:
Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json