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

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

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SHIPPING_PROGRAM&reportVersion=v1
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Accept: application/json
Content-Type: application/json {}

Sample request with filters

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

POST https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SHIPPING_PROGRAM&reportVersion=v1
Authorization: Bearer <access_token>
WM_QOS.CORRELATION_ID: <guid>
WM_SVC.NAME: Walmart Marketplace
Accept: application/json
Content-Type: application/json { "format": "CSV", "rowFilters": { "program": ["Two Day", "Three Day"], "sku": ["SKU-1001", "SKU-1002"] }
}

cURL

curl -X POST \ 'https://marketplace.walmartapis.com/v3/reports/reportRequests?reportType=SHIPPING_PROGRAM&reportVersion=v1' \ -H 'Authorization: Bearer <access_token>' \ -H 'WM_QOS.CORRELATION_ID: <guid>' \ -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

Check status until the report is ready.
```
GET https://marketplace.walmartapis.com/v3/reports/reportRequests/{requestId}
```
Status values: RECEIVED, INPROGRESS, READY, ERROR.

Download once status is READY.

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.

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