Get details of a claim

Call this endpoint to retrieve detailed information for a single shipment-protection claim. Use this endpoint to see the full details of one claim from your dashboard.

Note: This page describes an example using only the required parameters and inputs for retrieving claim details. For a full list of capabilities and options, refer to the Shipment Protection API reference.

Endpoint

GET https://marketplace.walmartapis.com/v3/claims/shipment-protection/claim/{claimNumber}

Sample request

Replace {claimNumber} with the claim number you received when you submitted the claim.

curl -X GET "https://marketplace.walmartapis.com/v3/claims/shipment-protection/claim/1000004" \ -H "Authorization: Basic <Base64EncodedConsumerKey:ConsumerSecret>" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "WM_QOS.CORRELATION_ID: 1234567890" \ -H "Accept: application/json"

import requests url = "https://marketplace.walmartapis.com/v3/claims/shipment-protection/claim/1000004"
headers = { "Authorization": "Basic <Base64EncodedConsumerKey:ConsumerSecret>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "1234567890", "Accept": "application/json"
} response = requests.get(url, headers=headers)
print("Status code:", response.status_code)
print("Response JSON:", response.json())

Modify your code

Replace 1000004 in the URL with your actual claimNumber.
Insert your Base64-encoded credentials in the Authorization header.
Use your own unique WM_QOS.CORRELATION_ID for tracing.
Add any additional optional headers if needed.

Sample response

{ "data": { "claimInfo": { "claimNumber": 1000004, "claimsGroup": "AWAITING_ACTION", "claimType": "DAMAGED", "status": "INITIATED", "returnOrderId": "167901382063297", "purchaseOrderId": "136167901382063297", "orderNo": "100000417976032", "trackingNo": "434777930100", "carrier": "FedEx", "claimAmount": { "amount": 5.37, "currency": "USD" }, "paymentStatus": "PENDING", "autoRejectCountdownMessage": "8" }, "orderDetails": { "customerName": "Ajay", "fulfillmentCenterId": "10900015173", "fulfillmentCenterName": "Shoes.com - 10900015173 - MP", "shipMethod": "EXPEDITED", "orderedDate": "Fri Mar 07 08:46:37 GMT 2025", "deliverByDate": "Fri Mar 07 08:46:37 GMT 2025", "shipByDate": "Fri Mar 07 08:46:37 GMT 2025", "itemsDetails": [ { "quantity": "2", "sku": "REWARDSY119", "productName": "Garden of Life Dr. Formulated Probiotics Once Daily Women's Shelf Stable 30 Capsules", "chargesPerItem": { "amount": 5.47, "currency": "USD" } } ] } }
}

Result

If successful, you'll receive HTTP status 200 OK and the JSON response above containing both header information and full order/item details for the specified claim.

Next steps

For a chronological log of status changes and agent notes, see the Get claim history guide.
To attach new documents or notes when requested, see the Submit additional information guide.
To download supporting documents as a ZIP, see the Download claim documents guide.

Updated about 5 hours ago