Get claim notifications - Claims - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Get claim notifications

This endpoint allows, through a valid token, to obtain notifications of the complaint by making a 'get' request to the complaints resource using the 'resource' field of the 'data' parameter from the Webhook notifications received from the topic. For more information about Webhook notifications, visit:
Request's parameters


The 'data.resource' received in the claims notification, indicates the path that must be accessed to retrieve the information.
Response parameters
Claim ID. Unique identifier used to reference a specific claim in the system, essential for tracking and managing these claims.
Defines the nature of the claim being processed. It can take one of the following values:
mediations: Refers to the process of mediating between parties in a claim.
cancel_purchase: Involves the process of cancelling a previously made purchase.
return: Pertains to the process of returning a purchased item.
View more
Indicates the current stage of the claim within the processing cycle involving the buyer and seller. It can take one of the following values:
claim: Initial stage of the claim process in which both the buyer and seller are involved.
dispute: Phase where the claim is under dispute or disagreement.
recontact: Stage in which one of the parties makes contact after the claim/dispute has been closed.
View more
Specifies the current state of the claim, indicating whether it is open or closed. It can take one of the following values:
opened: Indicates that the claim is open.
closed: Indicates that the claim is closed.
curl -X GET \
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
Sample answer
  "id": 5033102536,
  "type": "mediations",
  "stage": "dispute",
  "status": "closed",
  "parent_id": null,
  "client_id": 1569196570216262,
  "resource_id": 7138572864,
  "resource": "shipment",
  "reason_id": "PNR4071",
  "quantity_type": "total",
  "players": [
      "role": "mediator",
      "type": "payer",
      "user_id": 242829175,
      "available_actions": [
          "action": "recontact",
          "due_date": "2020-11-16T22:36:59.000-04:00",
          "mandatory": true
  "resolution": {
    "reason": "already_shipped",
    "date_created": "2020-10-02T01:12:31.000-04:00",
    "decision": [
    "closed_by": "mediator"
  "coverages": [
      "type": "bpp",
      "benefited": "complainant",
      "amount": 194.99,
      "resource": "shipment",
      "resource_id": 7138572864,
      "date_created": "2018-03-08T10:35:30.000-0400",
      "costs": [
          "role": "respondent",
          "amount": 194.99,
          "date_created": "2018-03-08T10:35:30.000-0400"
  "labels": [
      "name": "reputation",
      "value": "avoid",
      "admin_id": null,
      "date_created": "2018-03-08T09:56:00.078-0400"
  "site_id": "MLA",
  "date_created": "2020-09-30T09:48:06.000-04:00",
  "last_updated": "2020-10-02T01:12:31.000-04:00"