Retrieve a single item with full details (v4)

get

https://api-gateway.walmart.com/v4/items/{productId}

This request retrieves one item.

Example 1

GET https://api-gateway.walmart.com/v4/items/00012345678905

This request retrieves one item with the product ID of GTIN-14 00012345678905. The additional properties are not being requested, and the product ID is in the default GTIN-14 format.

Example 2

GET https://api-gateway.walmart.com/v4/items/XYZ12348?productIdType=SKU&includeFullItemDetails=YES

This request retrieves one item with the product ID of SKU XYZ12348. The additional properties are being requested, and the product ID is in the SKU format that is being used.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

productId

string

required

Product identifier.

The productId format by default is GTIN-14. Other formats, for example SKU or EAN, may be specified with the query parameter productIdType.

For more details, refer to the query parameter productIdType documentation.

Market availability: Global

Query Params

productIdType

string

enum

Defaults to GTIN

Specifies the product identifier type. The path parameter productId must also be specified.

Valid values are:

Value	Meaning
EAN	European article number.
GTIN	Global trade item number. This is the default `productIdType`. This uses the GTIN-14 format.
ISBN	International standard book number.
ITEM_ID	Appears at the end of the Walmart.com item page URL.
SKU	Stock keeping unit.
UPC	Universal product code. This is the GTIN-12 which consists of twelve numeric characters that identifies a company's individual product.
WIN	Walmart identification number.

Market availability: Global

Allowed:

includeFullItemDetails

string

enum

Defaults to NO

Specifies whether or not to return additional item information fields.

The additional information fields are:

walmartOrderableAttributes
itemConfigurations
attributeContentInsights
variantGroupInfo
additionalProductAttributes

If YES, all of the additional information fields are returned. You cannot specify a selection of fields.

If NO, the additional information fields are not returned.

Market availability: Global

Allowed:

Headers

WM_CONSUMER.CHANNEL.TYPE

string

Identifier that tracks the consumer request by channel.

Use the consumer channel type received during your onboarding.

Contact your system administrator or developer management for the WM_CONSUMER.CHANNEL.TYPE value.

Market availability: Global

WM_QOS.CORRELATION_ID

string

required

Unique identifier for each API call, used to track and debug issues.

Use a randomly generated GUID for this ID.

Market availability: Global

WM_SEC.ACCESS_TOKEN

string

required

Access token returned by the Create access token request.

This value is required for token-based authentication.

Market availability: Global

Responses

200Successful Operation

400Bad request

401Unauthorized

404Resource not found