Request a settlement report

Use this report to review detailed itemization of Walmart Fulfillment Services (WFS) and Multichannel Solutions (MCS) fees and credits for a selected time period. It provides a transaction-level view of charges, adjustments, and credits to help reconcile final WFS settlements.

Data freshness: Settlement data is refreshed in near real time. Different transaction types may post at different intervals.

Endpoint

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

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

Sample request

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SETTLEMENT&reportVersion=v1
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: <guid>
WM_SEC.ACCESS_TOKEN: <access-token>
WM_SVC.NAME: Walmart Service Name {}

Sample request with date filters

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SETTLEMENT&reportVersion=v1
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: <guid>
WM_SEC.ACCESS_TOKEN: <access-token>
WM_SVC.NAME: Walmart Service Name { "dataStartTime": "2025-10-01T00:00:00Z", "dataEndTime": "2025-10-31T23:59:59Z"
}

Use dataStartTime and dataEndTime to filter by transaction date. Confirm supported filters for your report version.

cURL

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SETTLEMENT&reportVersion=v1' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_QOS.CORRELATION_ID: <guid>' \ --header 'WM_SEC.ACCESS_TOKEN: <access-token>' \ --header 'WM_SVC.NAME: Walmart Service Name' \ --data '
{ "dataStartTime": "2024-08-01T00:00:00Z", "dataEndTime": "2024-08-31T23:59:59Z"
}
'

Use a new GUID for each call. Keep the requestId to track status and download the report.

Track and download

1. Check status

   HTTP

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

   Status values: RECEIVED, INPROGRESS, READY, ERROR.

2. Download

   HTTP

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

You can also subscribe to report status notifications instead of polling.

When to use this report

Use this report to:

• Investigate WFS settlement transactions at a granular level
• Review itemized WFS and MCS fees for a time period
• Analyze credits, refunds, and adjustments
• Reconcile transactions against payment summaries
• Validate return-related charges before submitting disputes

Report contents

The report includes transaction-level details such as:

• WFS fees and credits
• Multichannel Solutions (MCS) fees
• Storage-related charges
• Refunds, adjustments, and inventory-related events

Next steps

• Compare results with payment summaries
• Filter by transaction type or reason code to investigate charges
• Review return-related fees before submitting disputes