Retrieve negative feedback performance summary
Call this endpoint to retrieve the negative feedback performance summary for the past N days (defaults to 60 days). The payload includes overall rate and trend, GMV loss and trend, orders impacted and trend, performance standard and risk level, and improvement recommendations.
This page describes an example using only the required parameters and inputs to retrieve negative feed ack summary. For a full list of customization options and additional capabilities, refer to the Marketplace Insights API Reference.
The cumulativeRateTrend response parameter uses the statuses in the table below to explain if a trend is a positive or negative change. Trend indicates how this metric has changed compared to the previous report duration ending the day before.
| Color | Description |
|---|---|
| GREEN_UP GREEN_DOWN | A positive change or an improved performance in the metric compared to the previous report duration ending the day before. |
| NEUTRAL | Indicates no change in the metric compared to the previous report duration ending the day before. |
| RED_UP RED_DOWN | A negative change or decreased performance in the metric compared to the previous report duration ending the day before. |
Endpoint
GET https://marketplace.walmartapis.com/v3/insights/performance/negativeFeedback/summary
Sample request
Use this sample request to retrieve the negative feedback performance summary for the past 60 days.
curl --url 'https://marketplace.walmartapis.com/v3/insights/performance/negativeFeedback/summary?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" \ -H "Accept: application/json"
import requests url = "https://marketplace.walmartapis.com/v3/insights/performance/negativeFeedback/summary" 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", "Accept": "application/json"
} 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_IDfor each request. - Replace
WM_SEC.ACCESS_TOKENwith your valid access token obtained through authentication.
Sample response
This sample response summarizes the negative feedback performance for the selected reporting window, including overall rate, GMV loss, impacted orders, trend indicators, risk level, key drivers, and recommendations.
nonAccountableDriversare metrics that do not affect the Seller Performance Standards.sellerAccountableDriversare metrics that affect the Seller Performance Standards.- If an API response includes a single
Cumulativerate, it should be interpreted as the seller-accountable rate. - When a metrics API includes both a
Seller Accountableand anOverallorCumulativerate, the second value represents the total rate, calculated as the sum of seller-accountable and non-accountable drivers. - In this context,
OverallandCumulativeare equivalent and may be used interchangeably.
{ "payload": { "reportDuration": 0, "updatedTimestamp": "2025-12-01T06:30:45Z", "cumulativeRate": 0, "cumulativeRateTrend": "GREEN_UP", "gmvLoss": 0, "gmvLossTrend": "GREEN_UP", "ordersImpacted": 0, "ordersImpactedTrend": "GREEN_UP", "performanceStandard": "string", "performanceRiskLevel": "GOOD", "sellerAccountableDrivers": { "assemblyInstrRate": 0, "cancellationRate": 0, "carrierRate": 0, "itemSizeComfortRate": 0, "productQualityRate": 0, "packagingRate": 0, "damagedRate": 0, "defectiveRate": 0, "pricingFeedbackRate": 0, "incorrectItemRate": 0, "invalidTrackingRate": 0, "lateRate": 0, "lostRate": 0, "missingItemRate": 0, "itemNotAsDescRate": 0, "responseQualityRate": 0, "returnRate": 0, "miscellaneousRate": 0, "otherRate": 0 }, "nonAccountableDrivers": { "wfsRate": 0, "swwRate": 0 }, "recommendations": [ { "recommendation": "string", "moreInfoLink": "string" } ] }, "status": "string"
}
Result
This call returns a summary object with payload (metrics) and status (request state). If successful, the API returns an HTTP status 200 OK with a JSON response. The metrics reflect negative feedback summary for orders in the specified time duration.
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.
Updated about 9 hours ago
