AI resources
Claims
The Claims API allows managing the lifecycle of disputes and claims between buyers and sellers. This reference describes the available endpoints and how to interact with them.
Available endpoints
All the endpoints that make up the Claims integration.
| Operation | Path | Description |
| Get claim detailsGET | /post-purchase/v1/claims/{claim_id} | Returns the details of a claim: involved users, affected resource, current status, and claim type. |
| Search claimsGET | /post-purchase/v1/claims/search | Searches claims by filters such as status, type, or resource_id; returns paginated results. |
| Get claim reasonGET | /post-purchase/v1/claims/reasons/{reason_id} | Returns the reason associated with a reason_id, including sub-reasons and their hierarchy. |
| Get claim historyGET | /post-purchase/v1/claims/{claim_id}/status_history | Returns the history of statuses and actions a claim went through since it was opened. |
| Get claim evidenceGET | /post-purchase/v1/claims/{claim_id}/evidences | Lists the evidence uploaded for a claim, with its type, status, and upload date. |
| Get claim notificationsGET | /claim_resource | Gets the notifications for a claim from the resource field received in a webhook notification. |
| Operation | Path | Description |
| Get claim messagesGET | /post-purchase/v1/claims/{claim_id}/messages | Lists the messages exchanged between the parties of a claim, with author, date, and content. |
| Get file informationGET | /post-purchase/v1/claims/{claim_id}/attachments/{fileName} | Returns the metadata of an attached file: name, type, and moderation status. |
| Download attached filesGET | /post-purchase/v1/claims/{claim_id}/attachments/{fileName}/download | Downloads the binary content of a file attached to a claim. |
| Attach files to messagePOST | /post-purchase/v1/claims/{claim_id}/attachments | Uploads one or more files attached to a claim to support the position of one of the parties. |
| Send message with filePOST | /post-purchase/v1/claims/{claim_id}/actions/send-message | Sends a message with attached files to the communication thread of a claim. |
| Operation | Path | Description |
| Request claim mediationPOST | /post-purchase/v1/claims/{claim_id}/actions/open-dispute | Escalates a claim to Mercado Pago mediation when the parties cannot reach a direct agreement. |
| See expected resolutions in mediationGET | /post-purchase/v1/claims/{claim_id}/expected-resolutions | Lists the possible resolutions that Mercado Pago can apply when closing the mediation of a claim. |
| Operation | Path | Description |
| Upload shipping evidencePOST | /post-purchase/v1/claims/{claim_id}/actions/evidences | Uploads shipping evidence (tracking number, label, or other proof) to support the seller in a claim. |