--- updatedAt: 2026-06-24T20:07:28.000Z --- # Get items count by status This API retrieves the total number of items filtered by a specific status, such as PUBLISHED or UNPUBLISHED. [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/count": { "get": { "tags": [ "Items" ], "summary": "Get items count by status", "description": "This API retrieves the total number of items filtered by a specific status, such as PUBLISHED or UNPUBLISHED. ", "operationId": "getCountByStatus", "parameters": [ { "name": "status", "in": "query", "description": "Status of Item", "required": false, "schema": { "type": "string", "description": "Status of item to retrieve", "enum": [ "PUBLISHED", "UNPUBLISHED", "SYSTEM_PROBLEM", "IN_PROGRESS", "ALL" ] } }, { "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": { "type": "object", "properties": { "published": { "type": "integer", "format": "int32" } } }, "examples": { "ALL": { "value": { "All": 682 } }, "PUBLISHED": { "value": { "PUBLISHED": 99 } }, "UNPUBLISHED": { "value": { "UNPUBLISHED": 383 } } } }, "application/xml": { "schema": { "type": "object", "properties": { "published": { "type": "integer", "format": "int32" } } } } } }, "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": "MISSING_REQUEST_PARAM.GMP_ITEM_QUERY_API" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "The mandatory parameter(status) is missing." }, "info": { "type": "string", "description": "A brief summary of the error, often used for a quick understanding of the issue.\n\n", "example": "One or more mandatory request parameters are missing." }, "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": {} }, "field": { "type": "string", "description": "Specifies the field or parameter that caused the error, pinpointing exactly where the issue occurred.\n\n", "example": "description" } } } }, "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": "MISSING_REQUEST_PARAM.GMP_ITEM_QUERY_API" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "The mandatory parameter(status) is missing." }, "info": { "type": "string", "description": "A brief summary of the error, often used for a quick understanding of the issue.\n\n", "example": "One or more mandatory request parameters are missing." }, "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": {} }, "field": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.\n\n", "example": "description" } } } } } }, "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": {} } } } } } } } } } } } ```