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 identify high-performing items, diagnose underperforming items, and prioritize pricing or content updates.

Date range support

• ITEM_PERFORMANCE v1 and v2 support optional date range filters dataStartTime and dataEndTime. If you don't specify a date range, the report defaults to the previous 30 days.
• ITEM_PERFORMANCE v3 requires the dataStartTime, dataEndTime, and dateGranularity request body parameters.
• The maximum reporting period depends on the selected dateGranularity. See Maximum reporting period below.

Date range filters (applies to v1, v2, and v3)

• The max lookback period for the date range filter is 2 years from current date (current date minus dataStartTime must be less than or equal to 2 years).
• The dataEndTime must be less than or equal to the current date.
• The dataStartTime must be less than or equal to dataEndTime .

Maximum reporting window (applies to v3 only)

For ITEM_PERFORMANCE v3, the maximum reporting window depends on the selected dateGranularity.

Requests that exceed the supported reporting period return an error.

Endpoint

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

The request body is optional for ITEM_PERFORMANCE v1 and v2. When the request is accepted, the API returns a requestId that you can use to track the request status and download the report.

Request body parameters

The following request body parameters are required for ITEM_PERFORMANCE v3.

Incomplete reporting periods

If the requested date range includes a period that does not align with the natural boundaries of the selected aggregation period (meaning WEEKLY, MONTHLY, or QUARTERLY) the report returns a partial period of the requested range.

For example, a request with dataStartTime of December 1, 2025, and dataEndTime of February 19, 2026, returns three monthly rows. The February row represents a partial month because the requested date range ends before February 28, 2026. Refer to the Sample request with incomplete date range (v3) below.

Review the Data Start Time and Data End Time columns in the report to determine the actual reporting period represented by each record.

Sample request (v1)

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v1
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6
WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
WM_SVC.NAME: Walmart Service Name {}

Sample request (v3)

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v3
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6
WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
WM_SVC.NAME: Walmart Service Name { "format": "CSV", "dataStartTime": "2025-10-01T00:00:00Z", "dataEndTime": "2025-10-15T23:59:59Z", "dateGranularity": "DAILY"
}

Sample request with incomplete date range (v3)

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v3
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6
WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
WM_SVC.NAME: Walmart Marketplace { "format": "CSV", "dataStartTime": "2025-12-01T00:00:00Z", "dataEndTime": "2026-02-19T23:59:59Z", "dateGranularity": "MONTHLY"
}

Sample response

{ "requestId": "d09e9fd0-74bb-42c7-8d48-80d6cdbdf4b7", "requestStatus": "RECEIVED", "reportType": "ITEM_PERFORMANCE", "reportVersion": "v3"
}

cURL

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=ITEM_PERFORMANCE&reportVersion=v3' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ --header 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --data '
{ "dataStartTime": "2024-08-10T20:11:24.000Z", "dataEndTime": "2024-08-25T20:11:24.000Z", "dateGranularity": "DAILY", "rowFilters": [ { "type": "rangeFilter", "columnName": "Offer Start Date", "from": "2020-03-16" } ]
}'

Note: Use a new GUID for each request. Save the requestId so you can track the request status and download the report.

Track and download

1. Check the request status until the report is ready.

   HTTP

   GET https://marketplace.walmartapis.com/v3/reports/reportRequests/{requestId}

   Status values: RECEIVED, INPROGRESS, READY, and ERROR.

2. Download the report after the status changes to READY.

   HTTP

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

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

Report fields

Headers are case sensitive and appear exactly as shown below.

Note: Some catalogs include additional columns. The downloaded report is the source of truth for the complete list of report fields.

Error handling

Next steps

• Pricing and performance (overview)
• Use report filters
• Report scheduler API overview

Related

• Request a buy box insights report
• Request a promotions report