Intelligent search powered by OpenAI
Get claim notifications
GET
Request's parameters
PATH
CLAIM_RESOURCE
The 'data.resource' received in the claims notification, indicates the path that must be accessed to retrieve the information.string
REQUIRED
Response parameters
id
Claim ID. Unique identifier used to reference a specific claim in the system, essential for tracking and managing these claims.number
type
Defines the nature of the claim being processed. It can take one of the following values:string
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 morestage
Indicates the current stage of the claim within the processing cycle involving the buyer and seller. It can take one of the following values:string
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 morestatus
Specifies the current state of the claim, indicating whether it is open or closed. It can take one of the following values:string
opened: Indicates that the claim is open.
closed: Indicates that the claim is closed.
Request
curl -X GET \
'https://api.mercadopago.com/claim_resource'\
-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"
}