Sellers can use this endpoint to retrieve late shipment performance summary metrics for a selected reporting window (default 30 days). The response includes cumulative rate and trend, impacted orders and trend, performance standards and risk level, contributing drivers, and recommendations.

Endpoint

GET https://marketplace.walmartapis.com/v3/insights/performance/lateShipment/summary

Sample request

This sample request demonstrates how to retrieve late shipment metrics for the specified period.

curl -X GET "https://marketplace.walmartapis.com/v3/insights/performance/lateShipment/summary?reportDuration=30" \ -H 'Accept: application/json' \ -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ -H 'WM_MARKET: US' \ -H 'WM_SVC.NAME: Walmart Marketplace' \ -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ -H 'WM_GLOBAL_VERSION: 3.1'

import requests url = "https://marketplace.walmartapis.com/v3/insights/performance/lateShipment/summary"
params = {"reportDuration": 30} headers = { "Accept": "application/json", "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6", "WM_MARKET": "US", "WM_SVC.NAME": "Walmart Marketplace", "WM_SEC.ACCESS_TOKEN": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....", "WM_GLOBAL_VERSION": "3.1", # If your integration requires Basic auth for this endpoint, uncomment and set this: # "Authorization": "Basic <base64(ClientID:ClientSecret)>",
} resp = requests.get(url, params=params, headers=headers, timeout=60) # Handle non-2xx responses
if resp.status_code == 204: print("No content (204): no summary content found for the seller.")
else: resp.raise_for_status() data = resp.json() print(data)

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.
• Replace reportDuration with the number of days used to calculate the metric. The default value is 30.

Sample response

The sample response summarizes the late shipment details for the selected reporting window, including overall rate, GMV loss, impacted orders, trend indicators, risk level, key drivers, and recommendations.

• nonAccountableDrivers are metrics that do not affect the Seller Performance Standards.
• sellerAccountableDrivers are metrics that affect the Seller Performance Standards.

A successful response returns a JSON object with status and a payload containing the late shipment metrics.

{ "status": "OK", "payload": { "reportDuration": 30, "updatedTimestamp": "2025-02-16T18:32:11Z", "cumulativeRate": 0.0215, "cumulativeRateTrend": "YELLOW_UP", "ordersImpacted": 184, "ordersImpactedTrend": "YELLOW_DOWN", "performanceStandard": "0.03", "performanceRiskLevel": "MONITOR", "sellerAccountableDrivers": { "lateShipmentRate": 0.0090, "lateHandoverRate": 0.0105, "missingOrInvalidRate": 0.0020 }, "nonAccountableDrivers": { "weatherDelayRate": 0.0012, "miscellaneousRate": 0.0008 }, "recommendations": [ { "recommendation": "Improve carrier handover times to reduce late handover rate.", "moreInfoLink": "https://sellerhelp.walmart.com/" } ] }
}

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.
Allowed values: GOOD, MONITOR, URGENT.

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 late shipment summary for orders in the specified 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.