Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

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.

Get claim notifications - Claims - Mercado Pago Developers

Intelligent search powered by OpenAI 

Get claim notifications

GET

https://api.mercadopago.com/claim_resource
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: https://www.mercadopago.com/developers/en/docs/your-integrations/notifications/webhooks.
Request's parameters
PATH
CLAIM_RESOURCE
string

REQUIRED

The 'data.resource' received in the claims notification, indicates the path that must be accessed to retrieve the information.
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/claim_resource'\
    -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"
}