Discounts report

Use the Discounts report API to generate the discounts report for your Walmart Marketplace account. This report provides a consolidated view of all discounts created over a specified time period, including discount details, budget utilization, and item-level assignment and eligibility data.

It helps you review the status and performance of Extra Savings, Buy More and Save, and Promo Code discounts, and track how budget is consumed across your discount activity.

When to use this report

Audit discount activity across a specific date range
Track budget utilization and identify discounts approaching or exceeding their target budget
Review which items are assigned to each discount and their eligibility status
Export discount data for reconciliation or analysis in internal systems

How it works

The Discount report is generated asynchronously using the on-request report workflow:

Create a report request using reportType=DISCOUNT
Check the report status using the requestId
Download the report once the status is READY

Create report request

Sample request

curl -X POST "https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=DISCOUNT&reportVersion=v1" \
-H "WM_SEC.ACCESS_TOKEN: <access_token>" \
-H "WM_QOS.CORRELATION_ID: <uuid>" \
-H "WM_SVC.NAME: Walmart Marketplace" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "dataStartTime": "2026-06-01T00:00:00Z", "dataEndTime": "2026-06-30T23:59:59Z"
}'

Sample response

{ "requestId": "7a83b5f1-2c4d-4e1a-8b92-3d7f6e4c1a29", "requestStatus": "RECEIVED", "requestSubmissionDate": "2026-07-01T10:00:00Z", "reportType": "DISCOUNT", "reportVersion": "v1", "payload": { "dataStartTime": "2026-06-01T00:00:00Z", "dataEndTime": "2026-06-30T23:59:59Z" }
}

Track and download

Check status until the report is ready.

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

Status values: RECEIVED, INPROGRESS, READY, ERROR.

Download once status is READY.

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

If you prefer not to poll, subscribe to Report status notifications and receive a callback when the file is ready.