Guides
My Account

Recon Report

Overview

The Recon Report API provides data about your settlements, order transactions, commissions, shipping fees, taxes, adjustments, and refund information. This API has the latest API standards with more advanced functionality and improvements.

Endpoint

GET <https://marketplace.walmartapis.com/v3/report/reconreport/reconFile?reportVersion=v1>

Functionality

This API helps you reconcile:

  • Order-level sales
  • Refunds
  • Fees
  • Commissions
  • Shipping fees
  • Settlement adjustments.

Request sample

curl --request GET --url '<https://marketplace.walmartapis.com/v3/report/reconreport/reconFile?reportVersion=v1'> --header 'accept: application/octet-stream'

Modify your code

Add authentication headers

Include your Marketplace auth credentials to replace placeholders:

--header 'Authorization: Bearer \<ACCESS_TOKEN>' --header 'WM_CONSUMER.ID: \<CONSUMER_ID>' --header 'WM_QOS.CORRELATION_ID: <unique-correlation-id>'

Error handling

  • If 4xx/401: refresh tokens or check credentials
  • If 5xx/timeout: implement retries with exponential backoff and alerting
  • Validate file size (>0) after download to detect empty or truncated files

Response sample

string

Result

  • This API returns a reconciliation report file as a binary stream.
  • The reconciliation report can be parsed to extract transaction lines to your internal systems (enterprise resource planning, accounting, and payout tracking).
  • Proper handling ensures accurate financial matching (deposits versus transaction-level activity, fees, refunds).
  • Confirm file format (CSV, zipped CSV, etc.) for downstream parsing.
  • Keep an audit trail: record request time, correlation ID, filename, and file checksum.

Next Steps

Recon report (Legacy)

The Recon report (Legacy) API generates transaction-level details about your account, such as IDs, adjustments, refunds, commissions, shipping fees, and settlement totals. The recon report is generated in CSV file format for legacy systems that aren’t JSON compatible.

Recon Report JSON

The Recon report JSON Is a report of transactions, payouts, fees, refunds, and other financial activities in the JSON file format.

Available recon report dates (Legacy)

The Available recon report dates (Legacy) provides date ranges available to download in the recon report.

Available recon report dates

The available recon report dates provides the date ranges available to download in the recon report.

Payment statement report

The Payment statement report Is a high-level overview of the payouts on your account after the settlement cycle has closed.

Performance report

The Performance report details the payment performance on your account, so you can see how payments are performing during the current cycle.

Updated about 2 hours ago