--- updatedAt: 2026-06-29T20:15:51.000Z --- # Retrieve a single item (v3) This request retrieves an item and displays the item details. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Item Management", "description": "Use the Item Management API to set up and manage your items on Walmart.com.", "version": "1.0", "contact": { "name": "contact name" } }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://api-gateway.walmart.com", "description": "Production URL" } ], "tags": [ { "name": "View Items in Catalog", "description": "Use the View Items in Catalog endpoints to view all items in your catalog." } ], "paths": { "/v3/items/{sku}": { "get": { "tags": [ "View Items in Catalog" ], "operationId": "getAnItem", "summary": "Retrieve a single item (v3)", "description": "This request retrieves an item and displays the item details.", "parameters": [ { "name": "sku", "in": "path", "description": "Stock keeping unit (SKU) item identifier.\n\n

Market availability: Global

\n", "required": true, "schema": { "type": "string" }, "example": "RG-IRAE-79VD" }, { "in": "header", "name": "Accept", "required": false, "schema": { "type": "string" }, "description": "Specifies the data type expected in a response sent from the server.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| application/json | JSON format for data returned in response. |\n| application/xml | XML format for data returned in response. |\n\n

Market availability: Global

\n", "example": "application/xml" }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "required": false, "schema": { "type": "string" }, "description": "Identifier that tracks the consumer request by channel.\n\nUse the consumer channel type received during your onboarding.\n\nContact your system administrator or developer management for the correct `WM_CONSUMER.CHANNEL.TYPE` value.\n\n

Market availability: Global

\n", "example": "0f3e4dd4-0514-4346-b39d-…" }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "required": true, "schema": { "type": "string" }, "description": "Unique identifier for each API call, used to track and debug issues.\n\nUse a randomly generated GUID for this ID.\n\n

Market availability: Global

\n", "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "required": true, "schema": { "type": "string" }, "description": "Access token returned by the [Create access token request](https://developer.walmart.com/suppliers/reference/postcreateanaccesstoken).\n\nThis value is required for token-based authentication.\n\n

Market availability: Global

\n", "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM…" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "mart": { "type": "string", "description": "Specifies the marketplace name.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| ASDA_GM | ASDA general merchandise marketplace |\n| WALMART_CA | Walmart Canada marketplace |\n| WALMART_US | Walmart United States marketplace |\n| WALMART_MEXICO | ASDA general merchandise marketplace |\n", "enum": [ "ASDA_GM", "WALMART_CA", "WALMART_US", "WALMART_MEXICO" ] }, "sku": { "type": "string", "description": "Stock keeping unit (SKU) identifier assigned to the item." }, "wpid": { "type": "string", "description": "Alphanumeric item identifier generated by Walmart.", "example": "434K5CFOY8G7ZZZ" }, "upc": { "type": "string", "description": "Universal Product Code (UPC) item identifier.\n\nThis value is a 12-digit barcode used extensively for retail packaging in the United States.\n", "example": "889296686590" }, "gtin": { "type": "string", "description": "Global Trade Item Number (GTIN) compatible item identifier.\n\nThese values include Universal Product Code (UPC) and European Article Number (EAN). UPCs must be 12 or 14 digits in length. EANs must be 13 digits in length.\n", "example": "00012345678905" }, "productName": { "type": "string", "description": "Seller-specified alphanumeric product name.", "example": "Sterling Silver Blue Diamond Heart Pendant with 18in Chain" }, "shelf": { "type": "string", "description": "Walmart-assigned item shelf name.", "example": "Home Page" }, "productType": { "type": "string", "description": "Seller-specified alphanumeric product type identifier.", "example": "Diamond" }, "price": { "type": "object", "description": "Object containing item price information.", "properties": { "currency": { "type": "string", "description": "ISO-4217 currency code for the item's price.\n\nValid values include, but are not limited to:\n\n| Value | Meaning |\n| --- | --- |\n| CAD | Canadian dollar |\n| GBP | Great Britain/United Kingdom pound |\n| MXN | Mexican peso |\n| USD | United States dollar |\n", "example": "USD" }, "amount": { "type": "number", "description": "Price amount.", "example": 9.99 } } }, "publishedStatus": { "type": "string", "description": "Status of an item in the submission process.\n \nValid values are:\n \n| Value | Meaning |\n| --- | --- |\n| INPROGRESS | The item is still in the submission process and a publishing decision has not yet been made. |\n| PUBLISHED | The item has been accepted and is published. |\n| UNPUBLISHED | The item is not available on the site. It has either been rejected during the submission process or removed from the site. |\n", "example": "PUBLISHED" }, "unpublishedReasons": { "type": "object", "description": "Object containing information about why a product was not published. Unpublished item pages are not visible to users on Walmart.com", "properties": { "reason": { "type": "array", "description": "Array of strings detailing each reason an item is unpublished or not visible on Walmart.com.", "example": [ "This item is missing a primary image. Add a 'Main Image URL' and resubmit the item." ], "items": { "type": "string" } } } }, "lifecycleStatus": { "type": "string", "description": "Status describing where the item listing is in the overall lifecycle.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| ACTIVE | Indicates an active lifecycle status. |\n| ARCHIVED | Indicates an archived lifecycle status. |\n| RETIRED | Indicates a retired lifecycle status. |\n", "enum": [ "ACTIVE", "ARCHIVED", "RETIRED" ] } } }, "examples": { "Single Item Search - Success": { "value": { "itemResponse": { "mart": "WALMART_US", "sku": "1ASTORE", "wpid": "2EWUH14N144B", "upc": "405542921811", "gtin": "00405542921811", "productName": "Coca Cola Inland Hard Eva Digital Camera Case, Bla", "shelf": "[Home Page,Electronics,Cameras & Camcorders,Camera Accessories,Camera Bags & Portability,Camera Bags & Cases]", "productType": "Camera Bags & Cases", "price": { "currency": "USD", "amount": 0 }, "publishedStatus": "UNPUBLISHED", "unpublishedReasons": { "reason": [ "This item is missing a primary image. Add a 'Main Image URL' and resubmit the item." ] }, "lifecycleStatus": "ACTIVE" } } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "array", "description": "Array of objects containing error information.", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "Error code of the response.", "example": "UNAUTHORIZED.GMP_GATEWAY_API" }, "field": { "type": "string", "description": "Specifies which field contains the error.", "example": "UNAUTHORIZED" }, "description": { "type": "string", "description": "Description of the error.", "example": "Unauthorized" }, "info": { "type": "string", "description": "Information about the error.", "example": "Unauthorized token or incorrect authorization header.\n\nVerify that you are using the correct format: `Authorization: Basic Base64Encode(clientId:clientSecret)`.\n\nFor more information, refer to https://developer.walmart.com/suppliers/docs/authentication-management.\n" }, "severity": { "type": "string", "description": "Severity of the error.", "example": "ERROR" }, "category": { "type": "string", "description": "Category of the error.", "example": "DATA" }, "causes": { "type": "array", "description": "List of error causes", "items": { "type": "string", "description": "Cause of the error." } }, "errorIdentifiers": { "type": "object", "description": "Error identifiers associated with the error." } } } } } }, "examples": { "401 - Unauthorized Error": { "value": { "error": [ { "code": "UNAUTHORIZED.GMP_GATEWAY_API", "field": "UNAUTHORIZED", "description": "Unauthorized", "info": "Unauthorized token or incorrect authorization header.\n\nVerify correct format: `Authorization: Basic Base64Encode(clientId:clientSecret)`.\n\nFor more information, refer to https://developer.walmart.com/suppliers/docs/authentication-management.\n", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ] } } } } } }, "404": { "description": "Item Is Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "array", "description": "Array of objects containing error information.", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "Error code of the response.", "example": "CONTENT_NOT_FOUND.GMP_ITEM_QUERY_API" }, "field": { "type": "string", "description": "Specifies which field contains the error.", "example": "404_NOT_FOUND" }, "description": { "type": "string", "description": "Description of the error.", "example": "No items found for the input parameters." }, "info": { "type": "string", "description": "Information about the error.", "example": "Requested content could not be found." }, "severity": { "type": "string", "description": "Severity of the error.", "example": "INFO" }, "category": { "type": "string", "description": "Category of the error.", "example": "APPLICATION" }, "causes": { "type": "array", "description": "List of error causes", "items": { "type": "string", "description": "Cause of the error." } }, "errorIdentifiers": { "type": "object", "description": "Error identifiers associated with the error." } } } } } }, "examples": { "Single Item Search - Item Not Found": { "value": { "error": [ { "code": "CONTENT_NOT_FOUND.GMP_ITEM_QUERY_API", "field": "404_NOT_FOUND", "description": "No Items found for the input parameters.", "info": "Requested content could not be found.", "severity": "INFO", "category": "APPLICATION", "causes": [], "errorIdentifiers": {} } ] } } } } } } } } } }, "x-tagGroups": [ { "name": "1P Suppliers Items Reference", "tags": [ "Get Spec", "Item Taxonomy", "Item Setup", "View Items in Catalog", "View Item Catalog in Bulk", "Maintenance Actions" ] } ] } ```