Buscar reclamações

Este endpoint permite buscar, por meio de um token válido, quais reclamações pertencem a determinado usuário.

GET

https://api.mercadopago.com/post-purchase/v1/claims/search
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
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.
Response parameters
paging
object
Informações para paginação dos resultados da pesquisa.
data
array
Exibe os dados da reclamação.
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 APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
    
Response
{
  "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": "MLU",
      "date_created": "2020-09-30T09:48:06.000-04:00",
      "last_updated": "2020-10-02T01:12:31.000-04:00"
    }
  ]
}