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

Do not know how to start integrating? 

Check the first steps
Get claim details

GET

https://api.mercadopago.com/post-purchase/v1/claims/{claim_id}
This endpoint allows you to obtain, through a valid token, details of claims such as, for example, information about the users involved and the order that generated the claim.
Request's parameters
PATH
claim_id
number

REQUIRED

Claim ID. Unique identifier used to reference a specific claim in the system, essential for tracking and managing these claims.
Response parameters
id
number
Claim ID. Unique identifier used to reference a specific claim in the system, essential for tracking and managing these claims.
type
string
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
stage
string
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
status
string
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.
Request
curl -X GET \
    'https://api.mercadopago.com/post-purchase/v1/claims/{claim_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-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"
}