Request an item report
Use the Item report to audit core catalog attributes and listing readiness. This report provides field‑level data on items you have listed, including category mapping, compliance attributes, and discoverability signals.
Endpoint
POST https://marketplace.walmartapis.com/v3/reports/reportRequestsSample request
POST https://marketplace.walmartapis.com/v3/reports/reportRequests
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6
WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
header 'WM_SVC.NAME: Walmart Marketplace { "reportType": "ITEM", "format": "CSV"
}Sample response
{ "requestId": "f5d3a8b2-0000-1111-2222-333344445555", "reportType": "ITEM", "status": "RECEIVED", "createdTime": "2025-09-15T10:00:00Z"
}Track report status with the request report status API (GET /v3/reports/reportRequests/{requestId}).
When status is READY, download the file with the download report URL API GET /v3/reports/downloadReport?requestId={requestId}.
Report fields
Below is the full set of fields returned in the Item report.
| Field name | Description |
|---|---|
| SKU | Seller’s unique identifier for the item. |
| Product Name | Item title shown to customers. |
| Product ID | Product identifiers (WPID, GTIN, UPC). |
| Category | Assigned category for the item. |
| Brand | Brand provided by the seller. |
| Price | Current price. |
| Currency | Currency code (for example, USD). |
| Publish Status | Whether the item is published (PUBLISHED, UNPUBLISHED). |
| Item Creation Date | Date the item was created. |
| Item Page URL | URL of the product page. |
| Primary Image URL | URL of the main product image. |
| Ship Methods | Shipping options for an the item. |
| Shipping Weight | Weight of the item used in shipping calculations. |
| Shelf Name | Shelf name used in browse/search. |
| Fulfillment Lag Time | Seller‑defined order handling time in days. |
| Product Condition | Item condition (New, Refurbished, Used). |
| Buy Box Eligible | Whether the item is eligible for Buy Box rotation. |
| Item Last Updated | Timestamp when the item was last updated. |
Version history
- v6 (2023‑10‑17): Added
ProductCondition. - v5 (2023‑08-22): Added promotional price fields.
- v4 (2022‑09-28): Added
BuyBoxEligible. - v3 (2022‑04-12): Introduced
ShipsInOriginalPackaging. - v2 (2021‑10-14): Initial schema available.
Next steps
- Use use report filters to refine output.
- Automate recurring generation with the report scheduler API overview.