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:

See 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

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. See the API reference for the exact schema and field list.

Create request response (201 Created)

{ "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)

{ "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 to avoid polling.
Load the CSV into your planning system and compare to current on-hand inventory.
Use Report scheduler to automate recurring requests.