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:
For details on throttling, refer to the Walmart throttling documentation.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

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

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.

Allowed:
string
enum

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

string
enum

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

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.

Allowed:
boolean
enum

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

Allowed:
Headers
string
required

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

string

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

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.

string
required

Specifies the name of the Walmart service being called.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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