---
updatedAt: 2026-04-12T09:22:41.000Z
---

# 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](/us-marketplace/reference/getshipmentprotectionclaimhistory).

## Endpoint

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

## Sample request

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

```bash cURL
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"
```
```python
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

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

## Sample response

```json
{
  "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, refer to the [Get claim details guide](/us-marketplace/docs/get-claim-details-shipment-protection).
* To submit additional documents or notes when requested, refer to the [Submit additional information guide](/us-marketplace/docs/submit-additional-information-shipment-protection).
* To download supporting documents as a ZIP, refer to the [Download claim documents guide](/us-marketplace/docs/download-claim-documents-shipment-protection).