Get item count by status
Overview
Use the Get item count by status API to retrieve the number of items in your Walmart Marketplace seller catalog based on publication status.
Use this API to review the total number of items or retrieve counts for a specific status, such as published, unpublished, or in progress.
This API provides aggregate counts rather than detailed item records.
Use cases
- Retrieve the total number of items in your catalog
- Count published items
- Count unpublished items
- Review items with system problems
- Monitor items that are still in progress
Item status descriptions
Use the status query parameter to retrieve item counts based on the following statuses:
| Status | Description |
|---|---|
ALL | Returns the total number of items in your catalog, including published and unpublished items. |
PUBLISHED | Returns the number of items published and live on Walmart.com. |
UNPUBLISHED | Returns the number of items that are not published on Walmart.com. |
SYSTEM_PROBLEM | Returns the number of items with a system problem. |
IN_PROGRESS | Returns the number of items that are still being processed. |
To investigate unpublished items and their reasons, use Get all items or Get an item to retrieve item-level details.
Reference guide
This guide explains how to retrieve item counts using the status query parameter.
For complete endpoint details, refer to the Get item count by status API reference.
Endpoint
GET https://marketplace.walmartapis.com/v3/items/countRequest sample
The following request retrieves the count of published items.
curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/items/count?status=PUBLISHED' \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_MARKET: US" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json"import requests url = "https://marketplace.walmartapis.com/v3/items/count?status=PUBLISHED" headers = { "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "WM_GLOBAL_VERSION": "3.1", "Accept": "application/json"
} response = requests.get(url, headers=headers) print(response.text)Replace <ACCESS_TOKEN> with a valid access token and use a unique correlation ID for each request.
Modify your request
Set the status query parameter to retrieve the count for a specific item status.
Allowed values: ALL, PUBLISHED, UNPUBLISHED, SYSTEM_PROBLEM, IN_PROGRESS.
To retrieve the total number of items:
GET /v3/items/count?status=ALLTo retrieve published or unpublished item counts:
GET /v3/items/count?status=PUBLISHEDGET /v3/items/count?status=UNPUBLISHEDTo retrieve counts for other statuses, set status to SYSTEM_PROBLEM or IN_PROGRESS.
Response samples
The API contract provides the following examples.
For status=ALL:
{ "All": 682
}For status=PUBLISHED:
{ "PUBLISHED": 99
}For status=UNPUBLISHED:
{ "UNPUBLISHED": 383
}These values are illustrative.
Results
After a successful request, the API returns the number of items matching the specified status. Use these counts to review the publication state of items in your seller catalog.
Next steps
- Use Get all items to retrieve details about published or unpublished items.
- Use Get an item to investigate an individual listing.
- Use Monitor feed processing to check item setup or maintenance processing.
- Use Get item count by groups to review item counts by variant group.
Updated 4 days ago

