Retire a Virtual Pack

Use this endpoint when you want to retire a Virtual Pack offer that is no longer needed. Use the bundle SKU returned in bundles[].sku from the GET /v3/items?bundleType=VIRTUALPACK response.

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 retire a Virtual Pack offer that is no longer needed.

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

Endpoint

DELETE https://marketplace.walmartapis.com/v3/items/{sku}

Path parameter

Request sample

curl -X DELETE "https://marketplace.walmartapis.com/v3/items/111222333444" \ -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"

Modify your code

Use the sample request as a starting point, then update the values below to retire the correct Virtual Pack offer.

1. Replace WM_SEC.ACCESS_TOKEN with your valid access token.
2. Use a unique WM_QOS.CORRELATION_ID for each request.
3. Replace {sku} in the request path with the bundle SKU returned in bundles[].sku.
4. Use the bundle SKU from the GET /v3/items?bundleType=VIRTUALPACK response.
5. URL-encode the SKU if it contains special characters.

Response sample

{ "sku": "111222333444", "message": "Thank you. Your item has been submitted for retirement from Walmart Catalog. Please note that it can take up to 48 hours for items to be retired from our catalog.", "additionalAttributes": null, "errors": null
}

Result

On success, the bundle SKU is submitted for retirement. Retirement can take up to 48 hours. After retirement, the Virtual Pack is no longer active.

Errors and remediation

Next steps

1. Re-query GET /v3/items?bundleType=VIRTUALPACK to confirm the pack no longer appears.
2. Verify the correct bundle SKU was retired by checking bundles[].sku.
3. Confirm the item shows the expected retired or unpublished state.