--- updatedAt: 2026-06-24T20:07:28.000Z --- # Retire an item Use this API when you want to permanently retire an item identified by its SKU. **Retiring virtual pack items:** 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. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Item Management", "version": "1.0", "description": "The Item Management APIs enable you to set up and manage items on Walmart.com. Once you have completed Registration and have access to your Consumer ID and Private Key, you can get started with the integration process." }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "paths": { "/v3/items/{sku}": { "delete": { "tags": [ "Items" ], "summary": "Retire an item", "description": "Use this API when you want to permanently retire an item identified by its SKU.\n\n**Retiring virtual pack items:** 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.", "operationId": "retireAnItem", "parameters": [ { "name": "sku", "in": "path", "description": "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.", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.", "required": true, "schema": { "type": "string" }, "example": "eyJraWQiOiIxNWNhNGIyYi0yODVjLTQ0ZDUtYmExNC05ZDk1NTlkZmUwNjgiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0....." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Specifies the name of the Walmart service being called.", "required": true, "schema": { "type": "string" }, "example": "Walmart Marketplace" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "required": [ "sku" ], "type": "object", "properties": { "sku": { "type": "string", "description": "An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item." }, "message": { "type": "string", "description": "Message confirming the deletion or retirement of an item from the Walmart Catalog" } }, "xml": { "name": "ItemRetireResponse" } }, "example": { "sku": "97964_KFTest", "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 } }, "application/xml": { "schema": { "required": [ "sku" ], "type": "object", "properties": { "sku": { "type": "string", "description": "An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item." }, "message": { "type": "string", "description": "Message confirming the deletion or retirement of an item from the Walmart Catalog" } }, "xml": { "name": "ItemRetireResponse" } }, "example": "\n\n 97964_KFTest\n 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.\n" } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "A unique identifier for the type of error. This helps in quickly recognizing and categorizing the specific issue. \n", "example": "400" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "Bad Request" }, "info": { "type": "string", "description": "A brief summary of the error, often used for a quick understanding of the issue.\n\n", "example": "Invalid URL" }, "severity": { "type": "string", "description": "Indicates the criticality of the error. Common values include ERROR, WARNING, or INFO.\n\nExample: ERROR\n", "example": "ERROR" }, "category": { "type": "string", "description": "Classifies the error into a specific group or type, which helps in organizing and managing different types of issues.\n\nExample: DATA\n", "example": "DATA" }, "causes": { "type": "array", "description": "An array that can contain additional details or sub-errors that contributed to the main error. ", "example": [], "items": { "type": "string", "description": "Causes of the error.", "example": "[]" } }, "errorIdentifiers": { "type": "object", "description": "Includes additional identifiers or metadata that provides more context about the error.", "example": {} } } } }, "application/xml": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "A unique identifier for the type of error. This helps in quickly recognizing and categorizing the specific issue. \n", "example": "400" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "Bad Request" }, "info": { "type": "string", "description": "A brief summary of the error, often used for a quick understanding of the issue.\n\n", "example": "Invalid URL" }, "severity": { "type": "string", "description": "Indicates the criticality of the error. Common values include ERROR, WARNING, or INFO.\n\nExample: ERROR\n", "example": "ERROR" }, "category": { "type": "string", "description": "Classifies the error into a specific group or type, which helps in organizing and managing different types of issues.\n\nExample: DATA\n", "example": "DATA" }, "causes": { "type": "array", "description": "An array that can contain additional details or sub-errors that contributed to the main error. ", "example": [], "items": { "type": "string", "description": "Causes of the error.", "example": "[]" } }, "errorIdentifiers": { "type": "object", "description": "Includes additional identifiers or metadata that provides more context about the error.", "example": {} } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "A unique identifier for the type of error. This helps in quickly recognizing and categorizing the specific issue. \n", "example": "500" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "Some error occurred" }, "severity": { "type": "string", "description": "Indicates the criticality of the error. Common values include ERROR, WARNING, or INFO.\n\nExample: ERROR\n", "example": "ERROR" }, "category": { "type": "string", "description": "Classifies the error into a specific group or type, which helps in organizing and managing different types of issues.\n\nExample: DATA\n", "example": "REQUEST" }, "causes": { "type": "array", "description": "An array that can contain additional details or sub-errors that contributed to the main error. ", "example": [], "items": { "type": "string", "description": "Causes of the error.", "example": "[]" } }, "errorIdentifiers": { "type": "object", "description": "Includes additional identifiers or metadata that provides more context about the error.", "example": {} } } } }, "application/xml": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "A unique identifier for the type of error. This helps in quickly recognizing and categorizing the specific issue. \n", "example": "500" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "Some error occurred" }, "severity": { "type": "string", "description": "Indicates the criticality of the error. Common values include ERROR, WARNING, or INFO.\n\nExample: ERROR\n", "example": "ERROR" }, "category": { "type": "string", "description": "Classifies the error into a specific group or type, which helps in organizing and managing different types of issues.\n\nExample: DATA\n", "example": "REQUEST" }, "causes": { "type": "array", "description": "An array that can contain additional details or sub-errors that contributed to the main error. ", "example": [], "items": { "type": "string", "description": "Causes of the error.", "example": "[]" } }, "errorIdentifiers": { "type": "object", "description": "Includes additional identifiers or metadata that provides more context about the error.", "example": {} } } } } } } } } } } } ```