Consultar um cliente
GET /property-v1/customers
Devolve a ficha do clientRef que você pedir.
curl https://property-api.mapaprop.com/property-v1/customers \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42"
Resposta 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" }
}
}
Se você ainda não declarou nada, responde 404 — e não um 200 com a ficha vazia, para que você possa
distinguir "não existe" de "existe e está incompleta".
Os dois 404
A sua verificação de "existe?" não muda: os dois são 404. O que muda é o corpo, porque a correção
é diferente em cada caso.
Você nunca o declarou
{
"error": "No hay una inmobiliaria declarada para este clientRef",
"detail": "Creala con POST /property-v1/customers antes de dar de alta propiedades."
}
→ POST, e você recebe um customerId novo.
Você deu baixa nele
{
"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"
}
→ o mesmo POST o reativa, e ele recupera o customerId que
já tinha.
Se a sua integração distingue os dois casos, olhe o campo error: customer_deleted diz que o
cliente existiu e que você vai recuperar o id dele. O outro 404 diz que você vai receber um novo.
Códigos de resposta
| Código | O que aconteceu |
|---|---|
200 | A ficha |
400 | Falta o header x-client-ref |
401 | Token ausente ou inválido |
403 | O seu token não tem o scope property-api-read |
404 | Não há ficha utilizável — os dois casos acima |