---
updatedAt: 2026-08-20T00:09:02.000Z
---

# Request an item report

Use the Item report to audit core catalog attributes and listing readiness. This report provides field‑level data on items you have listed, including category mapping, compliance attributes, and discoverability signals.

## Endpoint

```http
POST https://marketplace.walmartapis.com/v3/reports/reportRequests
```

## Sample request

```http
POST https://marketplace.walmartapis.com/v3/reports/reportRequests
Accept: application/json
Content-Type: application/json
WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6
WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....
header 'WM_SVC.NAME: Walmart Marketplace

{
  "reportType": "ITEM",
  "format": "CSV"
}
```

## Sample response

```json
{
  "requestId": "f5d3a8b2-0000-1111-2222-333344445555",
  "reportType": "ITEM",
  "status": "RECEIVED",
  "createdTime": "2025-09-15T10:00:00Z"
}
```

Track report status with the <Anchor target="_blank" href="https://developer.walmart.com/us-marketplace/reference/getsinglerequeststatus">request report status API</Anchor> (`GET /v3/reports/reportRequests/{requestId}`).

&#x20;When status is `READY`, download the file with the <Anchor target="_blank" href="https://developer.walmart.com/us-marketplace/reference/downloadreport">download report URL API </Anchor>`GET /v3/reports/downloadReport?requestId={requestId}`.

## Report fields

Below is the full set of fields returned in the Item report.

| Field name           | Description                                             |
| -------------------- | ------------------------------------------------------- |
| SKU                  | Seller’s unique identifier for the item.                |
| Product Name         | Item title shown to customers.                          |
| Product ID           | Product identifiers (WPID, GTIN, UPC).                  |
| Category             | Assigned category for the item.                         |
| Brand                | Brand provided by the seller.                           |
| Price                | Current price.                                          |
| Currency             | Currency code (for example, USD).                       |
| Publish Status       | Whether the item is published (PUBLISHED, UNPUBLISHED). |
| Item Creation Date   | Date the item was created.                              |
| Item Page URL        | URL of the product page.                                |
| Primary Image URL    | URL of the main product image.                          |
| Ship Methods         | Shipping options for an the item.                       |
| Shipping Weight      | Weight of the item used in shipping calculations.       |
| Shelf Name           | Shelf name used in browse/search.                       |
| Fulfillment Lag Time | Seller‑defined order handling time in days.             |
| Product Condition    | Item condition (New, Refurbished, Used).                |
| Buy Box Eligible     | Whether the item is eligible for Buy Box rotation.      |
| Item Last Updated    | Timestamp when the item was last updated.               |

## Version history

* **v6 (2023‑10‑17):** Added `ProductCondition`.
* **v5 (2023‑08-22):** Added promotional price fields.
* **v4 (2022‑09-28):** Added `BuyBoxEligible`.
* **v3 (2022‑04-12):** Introduced `ShipsInOriginalPackaging`.
* **v2 (2021‑10-14):** Initial schema available.

## Next steps

* Use [use report filters](/us-marketplace/docs/using-filters-when-requesting-reports) to refine output.
* Automate recurring generation with the [report scheduler API overview](/us-marketplace/docs/report-scheduler-api-overview).

<br />