Get all items

Overview

Use the Get all items API to retrieve items from your Walmart Marketplace seller catalog. The response includes product identifiers, item details, listing status, lifecycle status, pricing, and variant information.

Use this API to review your catalog, identify unpublished items, retrieve items belonging to a variant group, and check item availability.

For large catalogs, retrieve results in smaller batches using pagination.

Use cases

• Retrieve items from your seller catalog using SKU or GTIN.
• Filter items by lifecycle status, publication status, or variant group.
• Review item details, availability, and publication information.
• Retrieve additional duplicate or virtual pack information, where supported.
• Navigate large catalogs using pagination.

Reference guide

This guide explains how to retrieve items from your seller catalog and customize the results using query parameters.

For complete endpoint details, parameters, and response definitions, refer to the All items API reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/items

Request sample

The following request retrieves up to 20 items from the seller catalog.

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/items?limit=20&offset=0' \ -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.

Modify your request

Customize the results using query parameters to retrieve specific items, filter your catalog, or request additional item information.

Retrieve specific items

Use sku or gtin to retrieve matching items.

For example, retrieve items by SKU:

GET /v3/items?sku=30348_KFTest

Or retrieve items by GTIN:

GET /v3/items?gtin=06932096330348

Filter catalog items

Use lifecycleStatus, publishedStatus, or variantGroupId to narrow the results.

• lifecycleStatus: Filter by lifecycle state. Allowed values: ACTIVE, ARCHIVED, RETIRED.
• publishedStatus: Filter by publication status. Allowed values: PUBLISHED, UNPUBLISHED.
• variantGroupId: Retrieve items belonging to a specific variant group.

Example:

GET /v3/items?publishedStatus=UNPUBLISHED

You can also filter by condition or availability. Refer to the API reference for supported values.

Retrieve additional item information

Set showDuplicateItemInfo to true to request duplicate item information.

GET /v3/items?showDuplicateItemInfo=true

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

GET /v3/items?includeCustomerFavoritesStatus=true

To retrieve virtual pack information, set bundleType to VIRTUALPACK. You can also provide a component item's gtin to retrieve virtual packs associated with that component.

GET /v3/items?bundleType=VIRTUALPACK&gtin=06932096330348

Control pagination

The API supports offset-based and cursor-based pagination.

Offset-based pagination

Use offset and limit to retrieve items in batches.

The default offset is 0, and the default limit is 20. The maximum limit is 1000, and the maximum offset is 10000.

To retrieve the first 20 items:

GET /v3/items?offset=0&limit=20

To retrieve the next 20 items:

GET /v3/items?offset=20&limit=20

Cursor-based pagination

Use nextCursor to retrieve additional results when applicable.

The documented initial value is *, and the cursor is valid for two minutes.

Example:

GET /v3/items?nextCursor=*

For subsequent requests, use the cursor information returned by the API. An expired cursor returns a 400 Invalid Cursor error.

Response sample

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

{ "ItemResponse": [ { "mart": "WALMART_US", "sku": "SKU-06311216175845", "availability": "In_stock", "wpid": "389C68OHA8XI", "gtin": "06311216175845", "productName": "Blue Denim Jeans", "productType": "Jeans", "price": { "currency": "USD", "amount": 0 }, "publishedStatus": "UNPUBLISHED" } ], "totalItems": 1
}

The actual response may include additional item attributes and pagination information.

Results

After a successful request, the API returns matching items from your seller catalog, including product details, listing status, and variant information when available.

Next steps

• Use Get an item to retrieve details for a specific item.
• Use Catalog search to search your catalog using additional filters and sorting.
• Use Get item count by status to review catalog publication counts.
• Use Get item count by groups to review variant group counts.