Request an item report

Market availability: US | MX | CA

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
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.
LagTime	Seller‑defined order handling time in days.
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 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.