---
product_landing_hero:
 - title: Claims
 - message: 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.

:::AccordionComponent{title="Claims" pill="Core"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get claim details" href="/developers/en/reference/claims/get-claim-details/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}` | Returns the details of a claim: involved users, affected resource, current status, and claim type. |
| :TagComponent{tag="GET" text="Search claims" href="/developers/en/reference/claims/search-claims/get" color="accent"} | `/post-purchase/v1/claims/search` | Searches claims by filters such as status, type, or `resource_id`; returns paginated results. |
| :TagComponent{tag="GET" text="Get claim reason" href="/developers/en/reference/claims/get-reason-for-claim/get" color="accent"} | `/post-purchase/v1/claims/reasons/{reason_id}` | Returns the reason associated with a `reason_id`, including sub-reasons and their hierarchy. |
| :TagComponent{tag="GET" text="Get claim history" href="/developers/en/reference/claims/get-claim-history/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}/status_history` | Returns the history of statuses and actions a claim went through since it was opened. |
| :TagComponent{tag="GET" text="Get claim evidence" href="/developers/en/reference/claims/get-claim-evidence/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}/evidences` | Lists the evidence uploaded for a claim, with its type, status, and upload date. |
| :TagComponent{tag="GET" text="Get claim notifications" href="/developers/en/reference/claims/get-claim-notifications/get" color="accent"} | `/claim_resource` | Gets the notifications for a claim from the `resource` field received in a webhook notification. |

:::

:::AccordionComponent{title="Files and messages" pill="Management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get claim messages" href="/developers/en/reference/claims/get-claim-messages/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}/messages` | Lists the messages exchanged between the parties of a claim, with author, date, and content. |
| :TagComponent{tag="GET" text="Get file information" href="/developers/en/reference/claims/get-file-data/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}/attachments/{fileName}` | Returns the metadata of an attached file: name, type, and moderation status. |
| :TagComponent{tag="GET" text="Download attached files" href="/developers/en/reference/claims/download-attached-files/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}/attachments/{fileName}/download` | Downloads the binary content of a file attached to a claim. |
| :TagComponent{tag="POST" text="Attach files to message" href="/developers/en/reference/claims/attach-files-to-message/post" color="green"} | `/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. |
| :TagComponent{tag="POST" text="Send message with file" href="/developers/en/reference/claims/send-message-with-file/post" color="green"} | `/post-purchase/v1/claims/{claim_id}/actions/send-message` | Sends a message with attached files to the communication thread of a claim. |

:::

:::AccordionComponent{title="Resolutions" pill="Management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Request claim mediation" href="/developers/en/reference/claims/request-mediation-claim/post" color="green"} | `/post-purchase/v1/claims/{claim_id}/actions/open-dispute` | Escalates a claim to Mercado Pago mediation when the parties cannot reach a direct agreement. |
| :TagComponent{tag="GET" text="See expected resolutions in mediation" href="/developers/en/reference/claims/see-expected-resolutions-mediation/get" color="accent"} | `/post-purchase/v1/claims/{claim_id}/expected-resolutions` | Lists the possible resolutions that Mercado Pago can apply when closing the mediation of a claim. |

:::

:::AccordionComponent{title="Shipping" pill="Management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Upload shipping evidence" href="/developers/en/reference/claims/upload-shipping-evidence/post" color="green"} | `/post-purchase/v1/claims/{claim_id}/actions/evidences` | Uploads shipping evidence (tracking number, label, or other proof) to support the seller in a claim. |

:::

<br>
<br>

---
product_landing_how_integrate:
 - title: All set to get started?
 - sub_title: Go to the first endpoint and start managing claims.
 - button_description: Get claim
 - button_link: /developers/en/reference/claims/get-claim-details/get
---