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/reportRequests
Sample request
POST https://marketplace.walmartapis.com/v3/reports/reportRequests
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Content-Type: application/json { "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 GET /v3/reports/reportRequests/{requestId}. When status is READY, download the file with 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. |
| ProductName | Item title shown to customers. |
| ProductId | Global identifier (UPC, EAN, ISBN). |
| ProductIdType | Type of product ID (UPC, GTIN, ISBN). |
| Category | Assigned category for the item. |
| Brand | Brand provided by the seller. |
| Price | Current price. |
| Currency | Currency code (for example, USD). |
| PublishedStatus | Whether the item is published (PUBLISHED, UNPUBLISHED). |
| PublishedDate | Date the item was published. |
| PrimaryImageUrl | URL of the main product image. |
| AdditionalImageUrls | URLs of additional product images. |
| ShelfDescription | Short description used in browse/search. |
| LongDescription | Long description text. |
| ComplianceAttributes | Key compliance flags (hazmat, age restricted, etc.). |
| ShippingWeight | Weight of the item used in shipping calculations. |
| ShippingDimensions | Dimensions of the item (L × W × H). |
| LagTime | Seller‑defined order handling time in days. |
| ShipsInOriginalPackaging | Boolean flag indicating if the item ships in manufacturer packaging. |
| ProductCondition | Item condition (New, Refurbished, Used). |
| BuyBoxEligible | Whether the item is eligible for Buy Box rotation. |
| LastUpdated | Timestamp when the item was last updated. |
| Version | Schema version for this report row. |
Download: Item report fields (CSV)
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.
- See examples for ready‑to‑run cURL and Postman flows.
Updated 3 days ago