--- updatedAt: 2026-08-20T00:09:43.000Z --- # Request an inventory recommendations report Use this API to request, track, and download the **Inventory recommendations** report. This report surfaces inventory quantities to support near-term demand and improve Offer Listing Quality (OLQ). # When to use this report Use this report when you want to: * Display 14, 30, 45, and 60 day inventory forecasts for items you sell. * Identify items with low OLQ inventory scores. * Plan replenishment using item and category signals. # Prerequisites * Walmart Marketplace seller or partner account * OAuth 2.0 access token for the Reports API * Ability to store and process CSV files # Request the report ## Endpoint ``` POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=INVENTORY_RECOMMENDATIONS&reportVersion=v1 ``` The request body is optional. When accepted, the API returns a `requestId` that you use to check status and download the file. ## HTTP example ``` POST /v3/reports/reportRequests?reportType=INVENTORY_RECOMMENDATIONS&reportVersion=v1 Host: marketplace.walmartapis.com WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM..... WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6 WM_SVC.NAME: Walmart Marketplace Accept: application/json Content-Type: application/json {} ``` ## cURL ```json curl --request POST \ --url "https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=INVENTORY_RECOMMENDATIONS&reportVersion=v1" \ --header "WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." \ --header "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ --header "WM_SVC.NAME: Walmart Marketplace" \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{}" ``` ### Modify your code * Use a unique `WM_QOS.CORRELATION_ID` for each request. * Replace `WM_SEC.ACCESS_TOKEN` with your valid access token obtained through authentication. * Keep the returned `requestId` to track status and download. ## Sample response > The following examples illustrate typical shapes. Refer to the API reference for the exact schema and field list. **Create request response (201 Created)** ```json { "requestId": "b9f2a2a7-6f0c-4c3d-92b2-1d9f5f2b4e2a", "reportType": "INVENTORY_RECOMMENDATIONS", "reportVersion": "v1", "status": "RECEIVED", "submittedTs": "2026-01-09T18:22:11Z", "expiresAt": "2026-01-16T18:22:11Z", "links": [ { "rel": "self", "href": "/v3/reports/reportRequests/b9f2a2a7-6f0c-4c3d-92b2-1d9f5f2b4e2a" } ] } ``` **Check status response (200 OK)** ```json { "requestId": "b9f2a2a7-6f0c-4c3d-92b2-1d9f5f2b4e2a", "reportType": "INVENTORY_RECOMMENDATIONS", "reportVersion": "v1", "status": "READY", "submittedTs": "2026-01-09T18:22:11Z", "completedTs": "2026-01-09T18:24:03Z", "fileSizeBytes": 184327, "checksum": { "type": "MD5", "value": "dbf1f6b8a3d9d0d5b8c7c5aa1f1a2b33" }, "links": [ { "rel": "download", "href": "/v3/reports/downloadReport?requestId=b9f2a2a7-6f0c-4c3d-92b2-1d9f5f2b4e2a" } ] } ``` ## Filters **Not supported**. The file always includes all rows available to your account. After download, use your CSV tool to filter by SKU or other columns as needed. # Track status and download **1) Check status** ``` GET https://marketplace.walmartapis.com/v3/reports/reportRequests/{requestId} ``` Status values: `RECEIVED`, `INPROGRESS`, `READY`, `ERROR`. **2) Download when READY** ``` GET https://marketplace.walmartapis.com/v3/reports/downloadReport?requestId={requestId} ``` ## File format * **Type:** CSV * **Grain:** one row per `Item ID` and `GTIN` combination * **Headers:** case sensitive, exactly as shown **CSV columns** | Column | Description | Source | | ------------------- | -------------------------------------------------------- | ------- | | SKU | Seller’s unique identifier for the item | Seller | | Item ID | Walmart item ID on Walmart.com | Walmart | | GTIN | Global Trade Item Number for the item | Seller | | Product Name | Name of the product | Seller | | Product Category | Category of the product | Seller | | OLQ Inventory Score | Inventory component score of Offer Listing Quality (OLQ) | Walmart | | 14 Day Forecast | Forecast of inventory needed for the next 14 days | Walmart | | 30 Day Forecast | Forecast of inventory needed for the next 30 days | Walmart | | 45 Day Forecast | Forecast of inventory needed for the next 45 days | Walmart | | 60 Day Forecast | Forecast of inventory needed for the next 60 days | Walmart | # Errors | HTTP | Code | What it means | How to fix | | ---- | ----------------------- | --------------------------------------------------------- | ------------------------------------------------------- | | 400 | MISSING\_REQUEST\_PARAM | A required parameter is missing (for example reportType). | Add the missing parameter and retry. | | 400 | INVALID\_REQUEST | Unsupported reportType or invalid filter shape. | Check `reportType`, `reportVersion`, and filter format. | | 401 | UNAUTHORIZED | Invalid or missing OAuth token. | Refresh the token and retry. | | 404 | CONTENT\_NOT\_FOUND | Unknown or expired `requestId`. | Verify the `requestId` and retention window. | | 429 | RATE\_LIMIT\_EXCEEDED | Too many requests. | Back off and retry with jitter. | | 500 | INTERNAL\_ERROR | Unexpected error. | Retry `GET` calls. Contact support if it persists. | # Next steps * Set up [Report status notifications](/us-marketplace/docs/report-status-notifications) to avoid polling. * Load the CSV into your planning system and compare to current on-hand inventory. * Use [Report scheduler](/us-marketplace/docs/report-scheduler-api-overview) to automate recurring requests. # Related * [Request and download a report](/us-marketplace/docs/request-and-download-a-report) * [Report status notifications](/us-marketplace/docs/report-status-notifications) * [Create a report schedule](/us-marketplace/docs/create-a-report-schedule)