Request a pricing report

This guide covers the new Pricing recommendation-specific reports. Each report focuses on items associated with a particular pricing opportunity. The seven new downloadable Pricing recommendation reports help Walmart Marketplace sellers identify items associated with personalized Pricing Insights recommendations.

These reports are personalized based on each seller’s catalog, so not every report applies to every seller. The Small price gaps and Recent losses recommendations share the Improve BuyBox Wins Report.

For more information about Pricing Insights recommendations, refer to the Pricing Insights: Overview.

When to use these reports

• Review items associated with specific Pricing Insights recommendations.
• Identify pricing issues that may affect item visibility or publication.
• Find opportunities to improve Buy Box performance and price competitiveness.
• Evaluate aging inventory, repricer settings, and reduced referral fee opportunities.
• Export report data for analysis or follow-up pricing actions.

How it works

Pricing reports use the asynchronous on-request report workflow:

1. Create a report request with the appropriate reportType and reportVersion=v1.
2. Save the requestId returned by the API.
3. Check the request status until it is READY.
4. Retrieve the download URL and download the report.

Report relevance depends on your catalog and qualifying items.

Create report request

Use the Create Report Request API to request a Pricing report.

Endpoint: POST /v3/reports/reportRequests

Supported report types

Set reportType to one of the following values. These values are declared in the supplied OpenAPI specification.

Set reportVersion to v1 for these report types, as specified by the Create Report Request operation.

Sample request

The following example requests the Pricing Issues Report. Replace the access token with a valid token before sending the request.

curl -X POST "https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=PRICING_INSIGHTS_ISSUES&reportVersion=v1" \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_MARKET: US" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_SEC.ACCESS_TOKEN: <access_token>" \ -H "WM_GLOBAL_VERSION: 3.1" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{}'

Sample response

The following is an illustrative response based on the documented response schema.

{ "requestId": "7a83b5f1-2c4d-4e1a-8b92-3d7f6e4c1a29", "requestStatus": "RECEIVED", "requestSubmissionDate": "2026-10-22T15:00:00Z", "reportType": "PRICING_INSIGHTS_ISSUES", "reportVersion": "v1", "payload": {}
}

Track and download

1. Check the request status using the returned requestId.

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

Allowed status values: RECEIVED, INPROGRESS, READY, ERROR. Continue checking while the request is RECEIVED or INPROGRESS. If the status is ERROR, review the request and any returned error details. Report requests can be retrieved only within 30 days of creation.

2. Get the download URL when the status is READY.

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

The response includes downloadURL and downloadURLExpirationTime. Download the report before the URL expires.

For more information and usage examples, refer to the Create Report Request API reference.

Error handling

Note: The supplied specification explicitly documents the 400 response for report creation. The 401, 403, 429, and 500 response definitions are provided for report scheduling operations, not explicitly for the on-request report endpoints.

Available recommendation reports

Report fields

The following fields are listed for each of the seven new recommendation reports.

Pricing Issues Report

1. SKU
2. Item ID
3. Item Name
4. Item Condition
5. Publish Status
6. Publish Status Change Reason
7. Current Price
8. Shipping Price
9. Suggested Price
10. Price Gap to Suggested Price
11. Inventory
12. Traffic
13. Potential GMV

Stale Inventory Report

1. SKU
2. Item ID
3. Item Name
4. Customer Favorites
5. Total Inventory
6. Aged Inventory (Older than 12 months)
7. Last Sale Date
8. Current Price
9. Shipping Price
10. Suggested Price
11. Comparison Price
12. Estimated GMV
13. Traffic

Improve BuyBox Wins Report

This report supports the Small price gaps and Recent losses recommendations.

1. SKU
2. Item ID
3. Item Name
4. Customer Favorites
5. Buy Box Win Rate
6. Current Price
7. Shipping Price
8. Buy Box Price
9. Buy Box Shipping Price
10. Suggested Price
11. Price Gap
12. Inventory
13. Traffic

Improve PCS Report

1. SKU
2. Item ID
3. Item Name
4. Customer Favorites
5. Item PCS (%)
6. Impact on PCS
7. Original Price (Excludes WF Incentives)
8. Shipping Price
9. Competitor Price
10. Competitor Ship Price
11. Suggested Price (Inclusive of shipping)
12. Price Gap
13. Walmart-funded incentives
14. Traffic

Repricer Opportunities Report

1. SKU
2. Item ID
3. Item Name
4. Customer Favorites
5. Current Price
6. Shipping Price
7. Buy Box Price
8. Competitive Price
9. Suggested Min Price
10. Suggested Max Price
11. Inventory
12. Traffic
13. Walmart Funded Incentive Status
14. Promotion Status

Update Repricer Min Price Report

1. SKU
2. Item ID
3. Item Name
4. Strategy Name
5. Current Min Price
6. Suggested Min Price
7. Current Max Price
8. Inventory
9. Traffic
10. Customer Favorites

Reduced Referral Fee Opportunities Report

1. SKU
2. Item ID
3. Item Name
4. Current Price
5. Suggested Price
6. Current Referral Fee
7. Reduced Referral Fee
8. Seller Payout ($)
9. Expiry Date
10. Inventory
11. Traffic
12. Customer Favorites