---
updatedAt: 2026-08-20T00:09:48.000Z
---

# 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

```http
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

```http
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

```http
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
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

<br />