Retire an item

delete

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

Use this API when you want to permanently retire an item identified by its SKU. Market availability: Global

Virtual pack offers can also be retired with this endpoint. For a virtual pack, use the bundle SKU returned in the virtual pack retrieval response, for example, bundles[].sku. This value is system-generated by Walmart and often matches the virtual pack item ID. Market availability: US only

Path Params

sku

string

required

An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item. Special characters in the sku needing encoding are: ':', '/', '?', '#', '[', ']', '@', '!', '$', '&', "'", '(', ')', '*', '+', ',', ';', '=', as well as '%' itself. Other characters don't need to be encoded.

Market availability: Global

Headers

WM_SEC.ACCESS_TOKEN

string

required

Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.

Market availability: Global

WM_CONSUMER.CHANNEL.TYPE

string

A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding.

Market availability: Global

WM_QOS.CORRELATION_ID

string

required

A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.

Market availability: Global

WM_SVC.NAME

string

required

Specifies the name of the Walmart service being called.

Market availability: Global

WM_MARKET

string

enum

required

The target market of the API call.

Market availability: Global

Allowed:

WM_GLOBAL_VERSION

string

enum

required

The version of the global API used.

Market availability: Global

Allowed:

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful Operation

400Bad Request

500Internal Server Error