Listar reclamos
Devuelve los reclamos y quejas de la organización, ordenados por fecha de creación descendente (más recientes primero).
Requiere el permiso complaints.view. Si el miembro dueño del API key
tiene acceso restringido a ciertas tiendas, solo se devuelven los
reclamos de esas tiendas.
Authorization
ApiKeyAuth API key personal con el prefijo or_, enviada como
Authorization: Bearer or_xxxxxxxx.
Se genera desde Dashboard → Mi cuenta → API key. La clave solo se muestra una vez: en la base de datos se guarda únicamente su hash SHA-256.
In: header
Query Parameters
Número de página (empieza en 1).
1 <= value1Cantidad de resultados por página. El valor máximo es 100.
1 <= value <= 10020Filtra por estado del reclamo.
Value in
- "open"
- "in_review"
- "resolved"
Filtra por tipo: claim (reclamo, disconformidad con el producto o
servicio) o complaint (queja, disconformidad con la atención).
Value in
- "claim"
- "complaint"
Filtra por tienda (UUID).
uuidBúsqueda parcial (case-insensitive) sobre el correlativo, el nombre, el apellido o el código de seguimiento del consumidor.
Fecha de creación desde (inclusive). Acepta una fecha ISO
(YYYY-MM-DD) o una fecha-hora ISO; se toma el inicio del día.
dateFecha de creación hasta (inclusive). Acepta una fecha ISO
(YYYY-MM-DD) o una fecha-hora ISO; se toma el fin del día.
dateResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/complaints?page=1&pageSize=20&storeId=0192f3a0-9c5b-7b3e-8f1a-2c4d5e6f7a8b&search=RECL-000123&from=2026-01-01&to=2026-01-31"{ "data": [ { "id": "0192f3a0-9c5b-7b3e-8f1a-2c4d5e6f7a8b", "correlative": "000123", "trackingCode": "A1B2C3D4", "type": "claim", "status": "open", "priority": "medium", "storeId": "0192f39c-1d2e-7a4b-9c8d-1e2f3a4b5c6d", "storeName": "Tienda Miraflores", "reasonLabel": "Producto defectuoso", "firstName": "María", "lastName": "Quispe", "personType": "natural", "legalName": null, "legalTaxId": null, "documentType": "DNI", "documentNumber": "45678912", "email": "[email protected]", "itemType": "product", "incidentDate": "2026-01-12T00:00:00.000Z", "hasResponse": false, "respondedAt": null, "responseDeadline": "2026-01-30T23:59:59.000Z", "receiptDeliveryStatus": "sent", "responseDeliveryStatus": null, "createdAt": "2026-01-15T14:32:10.123Z", "updatedAt": null } ], "pagination": { "page": 1, "pageSize": 20, "total": 137, "totalPages": 7 }}