Search claims - Claims - Mercado Pago Developers
What are you looking for?

Do not know how to start integrating? 

Check the first steps
Claims search

GET

https://api.mercadopago.com/post-purchase/v1/claims/search
This endpoint allows searching, through a valid token, which claims belong to a certain user.
Request's parameters
QUERY
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
he 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
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.
Response parameters
paging
object
Information for pagination of search results.
data
array
Presents the data of the complaint.
Request
curl -X GET \
    'https://api.mercadopago.com/post-purchase/v1/claims/search?id=5039218470&type=mediations&stage=claim&status=closed&resource=shipment&resource_id=40128769543&date_created=2020-09-30T09:48:06.000-04:00&limit=5'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Sample answer
{
  "paging": {
    "offset": 0,
    "limit": 30,
    "total": 1
  },
  "data": [
    {
      "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",
        "benefited": "complainant",
        "closed_by": "mediator"
      },
      "site_id": "MLA",
      "date_created": "2020-09-30T09:48:06.000-04:00",
      "last_updated": "2020-10-02T01:12:31.000-04:00"
    }
  ]
}