Request a CPA report

Use this report to manage participation in the Competitive Price Adjustment (CPA) program. It returns the Item Opt-in file for all SKUs that are eligible for CPA. If a SKU is not in the report, it is not eligible. If the report is empty, none of your items are eligible.

How CPA affects payment: If the price displayed to the customer is lower than the price you submitted, you receive the same payment as if the item’s price had not been adjusted.
Example: You set item price $50 with $5 shipping. The customer sees $48 with $5 shipping and is charged $48 with $5 shipping. Your payout is based on $50 item price and $5 shipping.

Endpoint

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=CPA&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 file.

Sample request

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=CPA&reportVersion=v1
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Accept: application/json
Content-Type: application/json {}

cURL

curl -X POST \ 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=CPA&reportVersion=v1' \ -H 'Authorization: Bearer <access_token>' \ -H 'WM_QOS.CORRELATION_ID: <guid>' \ -H 'WM_SVC.NAME: Walmart Marketplace' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{}'

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

Track and download

1. Check status until the report is ready.

   HTTP

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

   Status values: RECEIVED, INPROGRESS, READY, ERROR.

2. Download once status is READY.

   HTTP

   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.

Filters

Filters are not supported for this report. The file always includes all rows available to your account. After download, use your CSV tool to filter by SKU or columns as needed.

CSV fields

The report contains one row per SKU that appears in your CPA Item Opt-in file. Headers are case sensitive and appear exactly as shown.

Your file is the source of truth for the final header list. Some catalogs may add columns.

Error handling

Common failures when requesting or downloading reports:

See also

• Pricing and performance (overview)
• Report scheduler API overview