Contactos
POST
Listar contactos
POST /api/parties/list-parties-admin
Descripción
Listado paginado de contactos del directorio.
Detalles
* Devuelve los contactos con paginación y búsqueda por nombre. * Cada contacto incluye la cantidad de direcciones, receptores de factura y vehículos vinculados. * Indica además si el contacto tiene rol de repartidor o proveedor registrado.
Permisos requeridos
parties.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | asc |
| withTotal | true |
| allowedSorts | [name, phone] |
Ejemplo de request
curl -X POST https://app.restofy.co/api/parties/list-parties-admin \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"parties": [
{
"partyId": 1,
"partyUuid": "8226cd64-7eb3-11f1-ac02-f2368af4d8ac",
"phone": "***",
"name": "Cliente Crédito",
"notes": null,
"isAvailable": 1,
"addressesCount": 0,
"invoiceRecipientsCount": 0,
"vehiclesCount": 0,
"isCourier": 0,
"isSupplier": 0
},
{
"partyId": 2,
"partyUuid": "82275bd0-7eb3-11f1-ac02-f2368af4d8ac",
"phone": "***",
"name": "Contacto Admin",
"notes": null,
"isAvailable": 1,
"addressesCount": 0,
"invoiceRecipientsCount": 0,
"vehiclesCount": 0,
"isCourier": 0,
"isSupplier": 0
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 2,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}