Get an item

Overview

Use the Get an item API to retrieve detailed information about a specific item in your Walmart Marketplace seller catalog.

You can identify an item using its SKU, GTIN, UPC, EAN, ISBN, or Walmart item ID. The response includes product information, listing status, lifecycle status, price, and other item attributes.

Use this API to verify item details, investigate publication issues, and review duplicate or variant information.

Use cases

• Retrieve an item using its SKU or another supported identifier
• Verify product details after item setup or maintenance
• Check an item's publication and lifecycle status
• Review duplicate item information
• Retrieve item availability and condition
• Review customer-favorite information, where supported

Reference guide

This guide explains how to retrieve an item using a supported identifier and interpret the response.

For complete endpoint details, refer to the An item API reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/items/{id}

Replace {id} with the item identifier.

Request sample

The following request retrieves an item using its SKU.

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/items/30348_KFTest?productIdType=SKU' \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_MARKET: US" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json"

Replace <ACCESS_TOKEN> with a valid access token and use a unique correlation ID for each request.

For Global API requests, set WM_MARKET to the applicable marketplace and WM_GLOBAL_VERSION to 3.1.

Modify your request

Retrieve an item by SKU

Pass the SKU as the id path parameter.

GET /v3/items/30348_KFTest

By default, the API treats the identifier as a SKU when productIdType is omitted.

You can also specify the identifier type explicitly:

GET /v3/items/30348_KFTest?productIdType=SKU

Retrieve an item using another identifier

Set productIdType to identify the format of the value supplied in {id}.

Allowed values: GTIN, UPC, ISBN, EAN, SKU, ITEM_ID

Market availability: ISBN and EAN are supported in the US marketplace only.

Filter by condition or availability

Market availability: US only

Use condition or availability to specify the item's condition or availability.

For example, to retrieve an item with the New condition:

GET /v3/items/30348_KFTest?productIdType=SKU&condition=New

To retrieve an item with Preorder availability:

GET /v3/items/30348_KFTest?availability=Preorder

For supported values, refer to the API reference.

Retrieve duplicate item details

Market availability: US only

To retrieve additional information about a duplicate item, set showDuplicateItemDetails to true.

GET /v3/items/06932096330348?productIdType=GTIN&showDuplicateItemDetails=true

Review duplicateItemDetails and its destinationItem information when returned.

The isDuplicate field indicates whether an item is identified as a duplicate. This field is omitted when productIdType is SKU.

Retrieve customer-favorite information

Market availability: US only

To retrieve customer-favorite information, set includeCustomerFavoritesStatus to true. When available, the response includes isCustomerFavorite.

GET /v3/items/30348_KFTest?includeCustomerFavoritesStatus=true

Response sample

The following abbreviated example illustrates the item information returned by the API.

{ "ItemResponse": [ { "mart": "WALMART_US", "sku": "30348_KFTest", "condition": "New", "availability": "Preorder", "wpid": "0RCPILAXM0C1", "gtin": "06932096330348", "productType": "Baby Carriers", "price": { "currency": "USD", "amount": 3 }, "publishedStatus": "PUBLISHED", "lifecycleStatus": "ACTIVE" } ]
}

The response is abbreviated for readability.

Results

After a successful request, the API returns information about the specified item, including product identifiers, item details, price, availability, and listing status. Duplicate and variant information may also be included when applicable.

Next steps

• Use Get all items to retrieve multiple catalog items.
• Use Catalog search to find items using additional search criteria.
• Use Get item associations to review item associations.
• Use Get item count by status to review publication counts.