Get claim history

Call this endpoint to audit how and when a claim moved through review. Use this endpoint to fetch a chronological log of status changes, agent notes, and any uploaded documents for a specific claim.

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

Endpoint

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

Sample request

Replace {claimNumber} with the claim number you want to inspect.

curl -X GET "https://marketplace.walmartapis.com/v3/claims/shipment-protection/claim/1000004/history" \ -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/history"
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": { "currentClaimStatus": "ACTION_NEEDED", "history": [ { "author": "Walmart Agent", "timestamp": "2025-02-10 05:04 PM", "status": "ACTION_NEEDED", "notes": "I’m reviewing your case #00000000 and it is necessary to add some pictures of the item that you sent to compare them to the item that you received. Could be a different item but same SKU." }, { "author": "Walmart Agent", "timestamp": "2025-02-10 05:04 PM", "status": "IN_REVIEW", "notes": "Please find here additional information substantiating my claim on the shipping protection of this return order from the seller.", "documents": [ { "id": "895711A7AA400000FB4D3BEB", "fileName": "fedex", "fileType": "jpg", "documentType": "PPOD" }, { "id": "8957124524A400000FB4D3BEB", "fileName": "ups", "fileType": "png", "documentType": "OTHER" } ] } ] }
}

Result

If successful, you'll receive HTTP status 200 OK and the JSON response above showing the full progression of your claim.

Next steps

To retrieve summary details for this claim, see the Get claim details guide.
To submit additional 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 3 hours ago