Contactos
POST
Buscar contacto por teléfono exacto
POST /api/parties/get-party-by-phone
Descripción
Devuelve el contacto cuyo teléfono coincide exactamente con el indicado.
Detalles
* Busca un contacto por coincidencia exacta del número de teléfono. * Si lo encuentra, retorna el contacto con todos sus sub-recursos (direcciones, vehículos, repartidores, receptores de factura y proveedores). * Si no existe ningún contacto con ese teléfono, la respuesta viene vacía.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| phone | string | Sí |
min:5
max:30
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/parties/get-party-by-phone \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"phone": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"phone": "***"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"party": {
"id": 3,
"phone": "***",
"name": "Lookup Cliente",
"notes": null,
"creditType": "none",
"creditLimitCents": null,
"accountId": null,
"addresses": [],
"vehicles": [],
"couriers": [],
"invoiceRecipients": [],
"suppliers": []
}
}
}