Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Search claims - Claims - Mercado Pago Developers
Which documentation 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-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    
Sample answer
{
  "paging": {
    "offset": 0,
    "limit": 30,
    "total": 1
  },
  "data": [
    {
      "id": 5033102536,
      "resource_id": 7138572864,
      "status": "closed",
      "type": "mediations",
      "stage": "dispute",
      "parent_id": null,
      "resource": "shipment",
      "reason_id": "PNR4071",
      "fulfilled": true,
      "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"
    }
  ]
}