An item

Use this API endpoint to retrieve detailed information about a specific item from the partner catalog. Pass the item identifier (id) as a path parameter. By default, the identifier is treated as a SKU unless productIdType is specified.

The response includes isDuplicate, which is true if the item is a duplicate and false otherwise. This field is omitted when productIdType is SKU.

To include customer favorite status in the response, set includeCustomerFavoritesStatus=true. When included, the response returns isCustomerFavorite, which indicates whether the item is currently favored by customers.

For variant items, the response includes variantGroupId, which identifies the group the item belongs to. When available, variantGroupInfo includes:

  • isPrimary: true if the item is the primary variant displayed in search results
  • groupingAttributes: An array of name/value pairs that represent the item's variant attributes (for example, color: Blue or size: M)

These fields are omitted for non-variant items.

Throttling:
This endpoint is throttled at a maximum of 900 transactions per minute (TPM) per seller. When called with the showDuplicateItemInfo parameter, this is reduced to 60 TPM.

Market availability: Global

Path Params
string
required

A unique seller-specified identifier for the item. Defaults to the SKU code.

Market availability: Global

Query Params
string
enum

Allows users to search by additional supported product identifiers (SKU, GTIN, EAN, ISBN, EAN, and Item ID). Use this parameter if you need to filter results based on a specific product ID type. If not specified, the call searches by SKU by default.
'ISBN', 'EAN' only available in US market.

Market availability: Global

Allowed:
string
enum

Indicates the condition of the product. Specify this parameter to filter items based on their condition.

Market availability: US only

string
enum

Specifies the product's availability status. Use this parameter to filter items by their availability status.

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. If not specified, default value is false.

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