Buscar reclamações - Reclamações - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos
Buscar reclamações

GET

https://api.mercadopago.com/post-purchase/v1/claims/search
Este endpoint permite buscar, por meio de um token válido, quais reclamações pertencem a determinado usuário.
Parâmetros de requisição
QUERY
id
number
ID da reclamação. Identificador único usado para referenciar uma reclamação específica no sistema, sendo essencial para rastrear e gerenciar estas reclamações.
type
string
Define a natureza da reclamação em processamento. Pode assumir um dos seguintes valores:
mediations: Refere-se ao processo de mediação entre as partes em uma reclamação.
cancel_purchase: Envolve o processo de cancelar uma compra previamente realizada.
return: Refere-se ao processo de devolução de um item comprado.
Ver mais
stage
string
Fase atual da reclamação dentro do ciclo de processamento que envolve o comprador e o vendedor. Pode assumir um dos seguintes valores:
claim: Fase inicial do processo de reclamação na qual intervém o comprador e o vendedor.
dispute: Fase em que a reclamação está em disputa ou desacordo.
recontact: Fase na qual uma das partes entra em contato após o encerramento da reclamação/disputa.
Ver mais
status
string
Estado atual da reclamação, indicando se está aberta ou fechada. Pode assumir um dos seguintes valores:
opened: Indica que a reclamação está aberta.
closed: Indica que a reclamação está fechada.
Parâmetros de resposta
paging
object
Informações para paginação dos resultados da pesquisa.
data
array
Exibe os dados da reclamação.
Requisição
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-5599*********291-02171*********139a4791e*********f7f5835-1*********' \
    
Resposta de exemplo
{
  "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"
    }
  ]
}