Buscar reclamos

Este endpoint permite buscar, mediante un token válido, qué reclamos pertenecen a un usuario determinado.

GET

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Query
id
number
ID del reclamo. Identificador único utilizado para hacer referencia a un reclamo específico en el sistema, esencial para rastrear y gestionar estos reclamos.
type
string
Define la naturaleza del reclamo que se está procesando. Puede tomar alguno de los siguientes valores:
mediations: Se refiere al proceso de mediación entre las partes en un reclamo.
cancel_purchase: Involucra el proceso de cancelar una compra previamente realizada.
return: Se refiere al proceso de devolver un artículo comprado.
Ver más
stage
string
La fase actual del reclamo dentro del ciclo de procesamiento que involucra al comprador y al vendedor. Puede tomar alguno de los siguientes valores:
claim: Fase inicial del proceso de reclamo en la que intervienen el comprador y el vendedor.
dispute: Fase donde el reclamo está en disputa o desacuerdo.
recontact: Fase en la que alguna de las partes se contacta luego de cerrado el reclamo/disputa.
Ver más
status
string
El estado actual del reclamo, indicando si está abierto o cerrado. Puede tomar alguno de los siguientes valores:
opened: Indica que el reclamo está abierto.
closed: Indica que el reclamo está cerrado.
Response parameters
paging
object
Información para paginación de resultados de búsqueda.
data
array
Presenta los datos de la reclamación.
Informa datos válidos en los request parameters antes de la ejecución.
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"
    }
  ]
}