--- updatedAt: 2026-05-07T15:23:22.000Z --- # Retrieve a single item This request retrieves a specific item by SKU in your Marketplace simulation environment. # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "Simulations API", "description": "API for managing simulations of seller items and orders in the Marketplace dynamic sandbox.", "version": "1.0.0", "contact": { "name": "Marketplace API Support" } }, "x-readme": { "samples-languages": [ "shell" ] }, "servers": [ { "url": "https://sandbox.walmartapis.com/v1", "description": "Sandbox URL" } ], "tags": [ { "name": "Simulations", "description": "Simulate items and orders in the Marketplace dynamic sandbox." } ], "paths": { "/simulations/items/{sku}": { "get": { "summary": "Retrieve a single item", "operationId": "getAnItem", "description": "This request retrieves a specific item by SKU in your Marketplace simulation environment.", "tags": [ "Simulations" ], "parameters": [ { "in": "header", "name": "WM_SANDBOX", "required": true, "schema": { "type": "string", "enum": [ "v2" ] }, "description": "Include this header to access the Marketplace dynamic sandbox environment.", "example": "v2" }, { "name": "sku", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stock keeping unit (SKU) identifier assigned to the item.", "example": "SKU011" }, { "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", "example": "application/json" }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "required": true, "schema": { "type": "string" }, "description": "Access token returned by the [Token API](https://developer.walmart.com/us-marketplace/reference/tokenapi).\n\nThis value is required for token-based authentication.\n", "example": "ACCESS_TOKEN_EXAMPLE" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Specifies the name of the Walmart service being called.", "required": true, "schema": { "type": "string" }, "example": "MP" } ], "responses": { "200": { "description": "Seller item with the specified SKU", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SellerItem" } } } }, "400": { "description": "Bad request", "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": "INVALID_REQUEST_HEADER.GMP_GATEWAY_API" }, "field": { "type": "string", "description": "Specifies which field contains the error.", "example": "WM_SVC.NAME" }, "description": { "type": "string", "description": "Description of the error.", "example": "WM_SVC.NAME set null or invalid." }, "info": { "type": "string", "description": "Information about the error.", "example": "One or more request headers are invalid." }, "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." } } } } } } } } }, "404": { "description": "Item 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." } } } } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "string", "description": "Unique identifier for the type of error.\n\nHelps in quickly recognizing and categorizing the specific issue.\n", "example": "SYSTEM_ERROR.GMP_ITEM_QUERY_API" }, "description": { "type": "string", "description": "Detailed message explaining what caused the error.\n\nProvides more context about the issue.\n", "example": "System encountered some internal error." }, "info": { "type": "string", "description": "Brief summary of the error, often used for a quick understanding of the issue.", "example": "One or more mandatory request parameters are missing." }, "severity": { "type": "string", "description": "Indicates the severity of the error.\nCommon values include ERROR, WARNING, or INFO.\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.", "example": "DATA" }, "causes": { "type": "array", "description": "Array containing additional details or sub-errors that contributed to the main error.", "example": [], "items": { "type": "string", "description": "Causes of the error." } }, "errorIdentifiers": { "type": "object", "description": "Includes additional identifiers or metadata that provides more context about the error.", "example": {} }, "field": { "type": "string", "description": "Specifies the field or parameter that caused the error, pinpointing exactly where the issue occurred.", "example": "Name is null" } } } } } } } } } }, "components": { "schemas": { "SellerItem": { "type": "object", "properties": { "sku": { "type": "string", "description": "Stock keeping unit (SKU) identifier assigned to the item.", "example": "SKU011" }, "productName": { "type": "string", "description": "Seller-specified, alphanumeric product name.", "example": "BabyBjorn Harmony 3D Mesh Baby Carrier for Infant" }, "productType": { "type": "string", "description": "Product type.", "example": "Baby Carrier" }, "condition": { "type": "string", "description": "Condition of the product (Such as `NEW` or `REFURBISHED`).", "example": "NEW" }, "price": { "type": "object", "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number", "description": "Product price.", "example": 249.99 }, "currency": { "type": "string", "description": "Price currency.", "example": "USD" } } } } } } } } ```