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

# Request a shipping program report

Use this report to view SKU-level shipping program details. It shows whether a SKU participates in Two Day or Three Day programs, its assigned shipping template, and coverage areas so you can audit readiness and fix gaps.

## Endpoint

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

```http
POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SHIPPING_PROGRAM&reportVersion=v1
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

{}
```

### Sample request with filters

Use `rowFilters` to scope the file to specific programs or SKUs.

```http
POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SHIPPING_PROGRAM&reportVersion=v1
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

{
  "format": "CSV",
  "rowFilters": {
    "program": ["Two Day", "Three Day"],
    "sku": ["SKU-1001", "SKU-1002"]
  }
}
```

### cURL

```bash
curl -X POST \
  'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SHIPPING_PROGRAM&reportVersion=v1' \
  -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \
  -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \
  -H 'WM_SVC.NAME: Walmart Marketplace' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \

  -d '{
        "format": "CSV",
        "rowFilters": {
          "program": ["Two Day"],
          "sku": ["SKU-1001"]
        }
      }'
```

> 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.

## Report fields

The downloaded ZIP contains a CSV with the following information. **Headers are case sensitive and appear exactly as shown.**

| Field                   | Description                                                                             | Origin  |
| ----------------------- | --------------------------------------------------------------------------------------- | ------- |
| `SKU`                   | Unique identifier for the item.                                                         | Seller  |
| `Item ID`               | Numeric identifier that uniquely identifies the item.                                   | Walmart |
| `Product Name`          | Name of the item.                                                                       | Seller  |
| `Publish Status`        | Status of the item in the submission process.                                           | Walmart |
| `Lifecycle Status`      | Status of the item in the overall lifecycle.                                            | Walmart |
| `Program Participation` | Indicates which program the SKU is enabled on. Possible values: `Two Day`, `Three Day`. | Walmart |
| `Template ID`           | Shipping template ID.                                                                   | Walmart |
| `Template Type`         | Shipping template type.                                                                 | Seller  |
| `Coverage Areas`        | Walmart-defined shipping regions for the program.                                       | Walmart |

> Your file is the source of truth for the final header list. Some programs add columns for regions or exceptions.

## Error handling

Common failures when requesting or downloading reports:

| HTTP | Code (example)          | When it happens                                         | How to fix                                              |
| ---- | ----------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
| 400  | `MISSING_REQUEST_PARAM` | Required parameter 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 your token and retry.                           |
| 404  | `CONTENT_NOT_FOUND`     | Unknown or expired `requestId`.                         | Verify the `requestId` and retention.                   |
| 429  | `RATE_LIMIT_EXCEEDED`   | Too many requests.                                      | Back off and retry with jitter.                         |
| 500  | `INTERNAL_ERROR`        | Unexpected error.                                       | Retry GET calls; contact support.                       |

## Next steps

* [Inventory and fulfillment readiness (overview)](/us-marketplace/docs/inventory-and-fulfillment-readiness)
* [Use report filters](/us-marketplace/docs/using-filters-when-requesting-reports)
* [Report status notifications](/us-marketplace/docs/report-status-notifications)

## Related

* [Request a shipping configuration report](/us-marketplace/docs/request-a-shipping-configuration-report)
* [Request a lag time report](/us-marketplace/docs/request-a-lag-time-report)