Request an item performance report

Use this report to measure sales and conversion for items in your catalog. It aggregates demand and performance metrics so you can spot winners, diagnose underperformers, and prioritize pricing or content updates.

Date range support: Item Performance reports support date range filters. The maximum lookback period is 2 years. If you do not pass a range, the report defaults to the last 30 days.

Endpoint

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v1

The request body is optional. When the request is accepted, the API returns a requestId you can use to track status and download the file.

Sample request

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v1
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Accept: application/json
Content-Type: application/json {}

Sample request with date filters

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v1
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Accept: application/json
Content-Type: application/json { "format": "CSV", "rowFilters": { "orderPlacedDt": { "from": "2025-10-01", "to": "2025-10-31" } }
}

cURL

curl -X POST \ 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v1' \ -H 'Authorization: Bearer <access_token>' \ -H 'WM_QOS.CORRELATION_ID: <guid>' \ -H 'WM_SVC.NAME: Walmart Marketplace' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "format": "CSV", "rowFilters": { "orderPlacedDt": { "from": "2025-10-01", "to": "2025-10-31" } } }'

Use a new GUID for each call. Keep the requestId to track status and download the report.

Track and download

Check status until the report is ready.
```
GET https://marketplace.walmartapis.com/v3/reports/reportRequests/{requestId}
```
Status values: RECEIVED, INPROGRESS, READY, ERROR.

Download once status is READY.

GET https://marketplace.walmartapis.com/v3/reports/downloadReport?requestId={requestId}

If you prefer not to poll, subscribe to Report status notifications and receive a callback when the file is ready.

CSV fields

Headers are case sensitive and appear exactly as shown below.

Field	Description	Origin
`Product Name`	Title of the product.	Seller
`Item ID`	Identifier number that Walmart uses for the product.	Walmart
`SKU ID`	Unique identifier for the item.	Seller
`Super Department`	Super department that the product belongs to.	Seller
`Department`	Department that the product belongs to.	Walmart
`Category`	Category of the product.	Walmart
`Sub Category`	Sub category of the product.	Walmart
`Brand`	Brand associated with the product.	Seller
`GMV`	Gross merchandise value = Authorized Sales - Canceled Sales - Refunded Sales.	Walmart
`Commission`	Commission paid to Walmart, taken from GMV.	Walmart
`GMV-Commission`	GMV minus Commission.	Walmart
`AUR`	Average unit retail = (Authorized Sales - Canceled Sales) / (Authorized Units - Canceled Units).	Walmart
`Total Units`	Authorized Units minus Canceled Units.	Walmart
`legacySlrId`	Unique seller ID.	Walmart
`Cancelled Units`	Total number of units canceled.	Walmart
`Cancelled Sales`	Total sales that were canceled.	Walmart
`Item Conversion Rate`	Percentage of orders converted into sales = total orders sold / total item (offer) visits.	Walmart
`Base Item Id`	Unique item identifier.	Walmart
`Total Product Visits`	Number of times customers visited the item at an offer level.	Walmart
`GMV Comp %`	Year-over-year GMV comparison = (GMV TY - GMV LY) / GMV LY.	Walmart
`Authorized Orders`	Total purchase orders that were placed and authorized.	Walmart
`Authorized Units`	Number of authorized units that were sold.	Walmart
`Authorized Sales`	Total authorized item sales.	Walmart
`Total LY GMV`	Last year GMV of the product.	Walmart
`Product Level Pageviews`	Number of times customers visited the item at a product level.	Walmart
`Product Level Conversion Rate`	Percentage of product pageviews converted into sales = total orders sold / total product visits.	Walmart
`Refunded Sales`	Total refunded item sales.	Walmart

Some catalogs include additional columns. Your file is the source of truth for the final header list.

Error handling

Common failures when requesting or downloading reports:

HTTP	Code (example)	When it happens	How to fix
400	`MISSING_REQUEST_PARAM`	Required parameter missing (for example, `reportType`).	Add the missing parameter and retry.
400	`INVALID_REQUEST`	Unsupported `reportType` or invalid filter shape.	Check `reportType`, `reportVersion`, and filter format.
401	`UNAUTHORIZED`	Invalid or missing OAuth token.	Refresh your token and retry.
404	`CONTENT_NOT_FOUND`	Unknown or expired `requestId`.	Verify the `requestId` and retention.
429	`RATE_LIMIT_EXCEEDED`	Too many requests.	Back off and retry with jitter.
500	`INTERNAL_ERROR`	Unexpected error.	Retry GET calls; contact support.