Call this endpoint to download a Microsoft Excel (.xlsx) file containing order-level data that affects your returns metrics. Use it API to audit spikes in returns and investigate specific SKUs .The optional reportDuration query filters to a trailing day window (default 60 days).

This page describes an example using only the required parameters and inputs to retrieve negative feedback report. For a full list of customization options and additional capabilities, refer to the Marketplace Insights API Reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/insights/performance/negativeFeedback/report

Sample request

Use this sample request to download the negative feedback performance report for the past 60 days.

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/insights/performance/negativeFeedback/report?reportDuration=60' \ -H "WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." \ -H "Authorization: Basic YzcyOTFjNmItNzI5MC00...." \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "WM_MARKET: US" 

import requests url = "https://marketplace.walmartapis.com/v3/insights/performance/returns/report" headers = { "WM_SEC.ACCESS_TOKEN": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....", "Authorization": "Basic YzcyOTFjNmItNzI5MC00....", "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_SVC.NAME": "Walmart Marketplace", "WM_GLOBAL_VERSION": "3.1", "WM_MARKET": "US"
} params = { "reportDuration": 60
} response = requests.get(url, headers=headers, params=params) print(response.status_code)
print(response.json())

Modify your code

• Use a unique WM_QOS.CORRELATION_ID for each request.
• Replace WM_SEC.ACCESS_TOKEN with your valid access token obtained through authentication.

Sample response

The following sample response shows the message displayed on successful file download.

string

Result

This call returns 200 OK with Excel file in body of the response.

Rate limits

If you submit too many feeds in a short period of time, you may exceed Walmart’s rate limits and receive HTTP 429 (Too Many Requests) responses. For more details on throttling and best practices, refer to the Rate Limiting Guide.