Get items with Virtual Packs

Use this endpoint to retrieve offers for Virtual Packs at a specific component item GTIN. The response helps you verify details such as SKU, price, and publish status, and review the current bundle SKU before retirement or maintenance updates. The response returns bundle offer details in bundles[].

To retrieve Virtual Pack offers for a specific component item, include the component item GTIN in the gtin query parameter.

This endpoint is available only to sellers who are enabled for Virtual Packs and onboarded to MLMQ. Contact Support for access.

Reference guide

This guide explains how to retrieve items with Virtual Pack offers. Use this endpoint to verify bundle details such as bundle SKU, bundle price, offer publish status, and the quantity included in each Virtual Pack.

For implementation details, refer to the Virtual Packs API reference guide.

Endpoint

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

Query parameters

Request sample: retrieve Virtual Packs for a component item

curl -X GET "https://marketplace.walmartapis.com/v3/items?bundleType=VIRTUALPACK&gtin=00011112223334" \ -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: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json"

Request sample: retrieve all items with Virtual Pack bundle information

curl -X GET "https://marketplace.walmartapis.com/v3/items?bundleType=VIRTUALPACK" \ -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: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json"

Response sample

{ "ItemResponse": [ { "mart": "WALMART_US", "sku": "VP-SAMPLE-SKU-001", "availability": "In_stock", "wpid": "1ABCDE2FGHIJ", "gtin": "00011112223334", "productName": "Sample Wireless Earbuds", "shelf": "[\"Electronics\",\"Audio\",\"Headphones\"]", "productType": "Earbuds", "price": { "currency": "USD", "amount": 19.99 }, "publishedStatus": "PUBLISHED", "lifecycleStatus": "ACTIVE", "isDuplicate": false, "bundles": [ { "bundleType": "VIRTUALPACK", "productName": "Sample Wireless Earbuds (2-Pack)", "offerPublishStatus": "PUBLISHED", "itemId": "111222333444", "sku": "111222333444", "mainImageUrl": "https://i5.walmartimages.com/asr/sample-earbuds-2pk.jpg", "price": { "currency": "USD", "amount": 36.99 }, "quantity": 2, "siteStartDate": "2026-01-01T00:00:00Z", "siteEndDate": "2027-12-31T23:59:59Z" } ] } ], "totalItems": 1
}

Modify your code

Use the sample request as a starting point, then update the values below to return the items and Virtual Pack offers you need.

1. Replace WM_SEC.ACCESS_TOKEN with your valid access token.
2. Use a unique WM_QOS.CORRELATION_ID for each request.
3. Set bundleType=VIRTUALPACK to return offers for Virtual Packs.
4. Add gtin={componentGtin} to retrieve offers for a specific component item.
5. Use nextCursor=* for the first page, then reuse the returned nextCursor for the next page.
6. Use limit to control page size.
7. Use offset if you want offset-based pagination instead of cursor-based pagination.

Response fields

Result

The response returns matching items in ItemResponse[]. Bundle offers are returned in ItemResponse[].bundles[].

Errors and remediation

Next steps

After reviewing Virtual Packs:

1. Use gtin to filter Virtual Pack offers for a specific component item.
2. Use bundles[].sku to identify the bundle SKU for a Virtual Pack offer.
3. Re-query the endpoint to confirm the pack’s publish status, price, or availability.