Submit additional information

Call this endpoint to attach photos, invoices, or notes to an existing shipment-protection claim when Walmart requests more details.

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

Endpoint

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

Sample request

Replace {claimNumber} with the claim number returned when you submitted your original claim.

curl -X PATCH "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" \ -F 'files=@"/file/path/photo.jpg"' \ -F 'documentTypes=[{"fileName":"photo.jpg","type":"OTHER"}]' \ -F 'notes="Here are the requested photos."'

import requests url = "https://marketplace.walmartapis.com/v3/claims/shipment-protection/claim/1000004"
files = { "files": open("/file/path/photo.jpg", "rb")
}
data = { "documentTypes": '[{"fileName":"photo.jpg","type":"OTHER"}]', "notes": "Here are the requested photos."
}
headers = { "Authorization": "Basic <Base64EncodedConsumerKey:ConsumerSecret>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "1234567890", "Accept": "application/json"
} response = requests.patch(url, headers=headers, files=files, data=data)
print("Status code:", response.status_code)
print("Response JSON:", response.json())

Modify your code

Replace 1000004 in the URL with your actual claimNumber.
Update the file path in files to point to your document.
Adjust the documentTypes JSON string to match your file names and types (PROOF_OF_DAMAGED_ITEM, INVOICE, or OTHER).
Modify notes with any additional context.
Insert your Base64-encoded credentials in the Authorization header.
Use your own unique WM_QOS.CORRELATION_ID for tracing.

Sample response

{ "data": { "message": "Claim documents uploaded successfully", "documents": [ { "id": "8958787967C00000D46C3AC4", "fileName": "photo.jpg", "fileType": "jpeg", "documentType": "OTHER" } ] }
}

Result

If successful, the API returns HTTP status 200 OK and a JSON response confirming document upload, including the list of uploaded document metadata.

Next steps

To retrieve summary details for this claim, see the Get claim details guide.
To audit the claim progression, see the Get claim history guide.
To download all supporting documents as a ZIP, see the Download claim documents guide.

Updated about 3 hours ago