Consultar un cliente
GET /property-v1/customers
Devuelve la ficha del clientRef que pidas.
curl https://property-api.mapaprop.com/property-v1/customers \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42"
Respuesta 200:
{
"customer": {
"customerId": "MAPAPROP-PA-000002",
"clientRef": "cliente-42",
"createdAt": "2026-10-01T02:54:30.980Z",
"updatedAt": "2026-10-01T02:54:30.980Z",
"name": "Inmobiliaria Modelo",
"phone1": "2234567890",
"email": "contacto@inmobiliaria-modelo.test",
"country": 1,
"branch": { "name": "Sucursal Centro", "phone1": "2234567891" }
}
}
Si todavía no declaraste nada, responde 404 — no un 200 con la ficha vacía, para que puedas
distinguir "no existe" de "existe y está incompleta".
Los dos 404
Tu chequeo de "¿existe?" no cambia: los dos son 404. Lo que cambia es el cuerpo, porque el
arreglo es distinto en cada caso.
Nunca lo declaraste
{
"error": "No hay una inmobiliaria declarada para este clientRef",
"detail": "Creala con POST /property-v1/customers antes de dar de alta propiedades."
}
→ POST, y recibís un customerId nuevo.
Lo diste de baja
{
"error": "customer_deleted",
"detail": "Esta inmobiliaria fue dada de baja el 2026-10-01T18:22:04.117Z. Volvé a crearla con POST /property-v1/customers: recupera el mismo customerId (MAPAPROP-PA-000002) y sus propiedades.",
"deletedAt": "2026-10-01T18:22:04.117Z",
"customerId": "MAPAPROP-PA-000002"
}
→ el mismo POST lo reactiva, y recupera el customerId
que ya tenía.
Si tu integración distingue los dos casos, mirá el campo error: customer_deleted te dice que el
cliente existió y que vas a recuperar su id. El otro 404 te dice que vas a recibir uno nuevo.
Códigos de respuesta
| Código | Qué pasó |
|---|---|
200 | La ficha |
400 | Falta el header x-client-ref |
401 | Token ausente o inválido |
403 | Tu token no tiene el scope property-api-read |
404 | No hay ficha usable — los dos casos de arriba |