---
updatedAt: 2026-07-30T22:19:44.000Z
---
# 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
```http
GET https://marketplace.walmartapis.com/v3/items
```
## Query parameters
| Name | Type | Required | Description |
| ------------ | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| `bundleType` | string | Yes | Filter items by bundle type. Allowed value: `VIRTUALPACK`. |
| `gtin` | string | No | GTIN of the component item. Use with `bundleType=VIRTUALPACK` to retrieve Virtual Packs for a specific component item. |
| `nextCursor` | string | No | Cursor for pagination. Use `*` for the first page. |
| `offset` | string | No | Zero-based index of the first item to return. |
| `limit` | string | No | Number of items to return per request. |
## Request sample: retrieve Virtual Packs for a component item
```bash
curl -X GET "https://marketplace.walmartapis.com/v3/items?bundleType=VIRTUALPACK>in=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
```bash
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
```json
{
"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
| Field | Description |
| -------------------------------- | ---------------------------------------------------------------------------------------- |
| `ItemResponse[].gtin` | GTIN of the component item. |
| `ItemResponse[].sku` | SKU of the component item. |
| `ItemResponse[].publishedStatus` | Publishing status of the component item. |
| `ItemResponse[].lifecycleStatus` | Lifecycle status of the component item. Allowed values: `ACTIVE`, `ARCHIVED`, `RETIRED`. |
| `ItemResponse[].bundles[]` | Bundle offers associated with this item. Returned when bundleType is specified. |
| `bundles[].bundleType` | Bundle type for the offer. Allowed value: `VIRTUALPACK`. |
| `bundles[].productName` | Display name of the bundle offer. |
| `bundles[].offerPublishStatus` | Publish status of the bundle offer. Example values: `PUBLISHED`, `UNPUBLISHED`. |
| `bundles[].itemId` | Walmart-assigned item ID for the bundle offer. |
| `bundles[].sku` | SKU for the bundle offer. |
| `bundles[].mainImageUrl` | Main image URL for the bundle offer. |
| `bundles[].price.currency` | Currency code for the bundle price. Example: `USD`. |
| `bundles[].price.amount` | The bundle price. |
| `bundles[].quantity` | Number of component units included in the Virtual Pack. Allowed values: `2` to `6`. |
| `bundles[].siteStartDate` | Date and time when the Virtual Pack offer becomes active on the site. |
| `bundles[].siteEndDate` | Date and time when the Virtual Pack offer expires on the site. |
| `totalItems` | Total number of items that match the query. |
| `nextCursor` | Cursor value to use for retrieving the next page of items. |
## Result
The response returns matching items in `ItemResponse[]`. Bundle offers are returned in `ItemResponse[].bundles[]`.
## Errors and remediation
| Status code | Scenario | Description | Recommended action |
| ----------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `400` | Virtual Packs are not enabled | Virtual Packs are not enabled. | Confirm that the seller is enabled for Virtual Packs. |
| `400` | GTIN is missing or blank | Provide a valid GTIN for Virtual Pack search. | Include a valid `gtin` value in the request. |
| `400` | `sku` parameter passed with `bundleType=VIRTUALPACK` | The `sku` parameter is not supported with `bundleType=VIRTUALPACK`. Use `gtin` instead. | Remove `sku` from the request and use `gtin`. |
| `400` | `variantGroupId` parameter passed with `bundleType=VIRTUALPACK` | The `variantGroupId` parameter is not supported with `bundleType=VIRTUALPACK`. Use `gtin` instead. | Remove `variantGroupId` from the request and use `gtin`. |
| `500` | Internal server error occurred while processing the request | The system encountered an unexpected error while processing the request. | Retry with a new `WM_QOS.CORRELATION_ID`. If the issue continues, capture the full error payload and correlation ID for support. |
## 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.