Home
Documentation
Resources
Certifications
Community

Resources

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

Community

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

Get claim history - Claims - Mercado Pago Developers

Intelligent search powered by OpenAI 

Get claim history

GET

https://api.mercadopago.com/post-purchase/v1/claims/{claim_id}/status_history
This endpoint allows you to view, through a valid token, the history of states and scenarios that the complaint has gone through. It will also be possible to consult the history of actions taken by the people responsible for the complaint.
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
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.
date
string
Date of change in claim status.
change_by
string
Indicates the person who changed the claim. It can take one of the following values:
complainant: Person who claims
respondent: Person to whom they are complaining.
mediator: Person who intervenes to help solve the problem.
Request
curl -X GET \
    'https://api.mercadopago.com/post-purchase/v1/claims/{claim_id}/status_history'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    
Sample answer
[
  {
    "stage": "dispute",
    "status": "closed",
    "date": "2020-09-08T23:59:36.000-04:00",
    "change_by": "mediator"
  }
]