Call this endpoint to retrieve ship-from location accuracy metrics for a period specified by reportDuration. This metric tracks the percentage of the Simplified Shipping Settings orders that shipped from the same location configured in your Simplified Shipping Settings. You can use this API to monitor how accurately your configured ship-from locations match the actual fulfillment behavior. For more details about performance standards, refer to Seller Performance Standards.

This page describes an example using only the required parameters and inputs to retrieve ship-from location accuracy summary metrics. 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.

Endpoint

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

Sample request

This sample request demonstrates how to retrieve ship-from location accuracy metrics for the specified period.

curl -X GET "https://marketplace.walmartapis.com/v3/insights/performance/sss/sfla/summary?reportDuration=30" \ -H "Authorization: Basic YzcyOTFjNmItNzI5MC00...." \ -H "WM_SEC.ACCESS_TOKEN: {ACCESS_TOKEN}" \ -H "WM_QOS.CORRELATION_ID: 9f6d2f2f-2c5e-4a76-9a9f-2a6b8f0a1234" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "accept: application/json"

import requests url = "https://marketplace.walmartapis.com/v3/insights/performance/sss/sfla/report" headers = { "Authorization": "Basic <BASIC_AUTH_B64>", "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "WM_CONSUMER.CHANNEL.TYPE": "<CHANNEL_ID>", "WM_QOS.CORRELATION_ID": "9f5e7f67-dc5b-4c1f-9d3f-1a9a2bbf1a12", "WM_SVC.NAME": "Walmart Marketplace", "Accept": "application/octet-stream",
} params = {"reportDuration": 30} response = requests.get(url, headers=headers, params=params)
print(response.status_code) with open("sss-sfla-report.xlsx", "wb") as f: f.write(response.content)

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 (14, 30, 60, 90) of order data that you want to include in metric calculations.

Sample response

This sample response shows a summary of the ship-from location accuracy for a 30 day report duration.

{ "payload": { "reportDuration": 30, "updatedTimestamp": "2025-02-02T19:49:56Z", "cumulativeAccuracy": 97.1, "cumulativeAccuracyTrend": "GREEN_UP", "impactedOrderCount": 1, "impactedOrderTrend": "GREEN_UP", "recommendedAccuracy": 100, "infractionDrivers": { "Mount Bethel, PA": 2.86 } }, "status": "OK"
} 

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 orders that shipped from the same location configured in your Simplified Shipping Settings.

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.