Solicita acceso
Cuéntanos sobre tu empresa, condominio y caso de uso.
Habitanto para integradoresAPI de consulta
API de consulta
de morosidad
Una integración sencilla para consultar si un contacto presenta deuda vencida dentro del condominio autorizado.
Integración segura · Respuesta mínima · Sin datos financieros
GET
/v1/morososAuthorization
Bearer hbt_live_••••••••••••Query
cedula=1712345678200 OKtrue
✓
Consulta seguraInformación autorizada
Simple por diseño
¿Qué es esta API?
Una integración sencilla para consultar si un contacto presenta deuda vencida dentro del condominio autorizado.
La respuesta se limita a un valor booleano: true o false. No expone nombres, montos, unidades ni información financiera detallada.
01Acceso controladoCada credencial está asociada a un condominio.
02Información necesariaLa API utiliza únicamente los datos requeridos para cada operación.
Integración directa
Cómo funciona
De la solicitud de acceso a tu primera operación en cuatro pasos.
Obtén tu Bearer Token
Recibe una credencial única para autenticar tus consultas.
Consume el endpoint
Envía la cédula o el correo mediante una solicitud GET.
Recibe la información
Procesa una respuesta booleana, simple y predecible.
Seguridad
Autenticación
Las APIs utilizan una credencial única asociada al condominio autorizado. Inclúyela en cada solicitud mediante el header Authorization o X-API-Key; no necesitas enviar el identificador del condominio.
✓ Guarda la credencial en variables de entorno.✓ Nunca la expongas en aplicaciones frontend.✓ Revoca de inmediato una credencial comprometida.
Headers admitidosUno requerido
X-API-Key: {API_KEY}O mediante Bearer Token
Authorization: Bearer {API_KEY}401 Unauthorized.Referencia esencial
Endpoint disponible
Todo lo necesario para realizar una integración, en un solo lugar.
GET
/v1/morosos DisponibleURL base
https://api.habitanto.comHeader
Authorization: Bearer {TOKEN}Parámetros de consulta
Envía al menos la cédula o el correo del contacto.
cedulastringCédula registrada del contacto.
CondicionalcorreostringCorreo principal o secundario.
CondicionalEjemplo requestcURL
curl --request GET \ --url 'https://api.habitanto.com/v1/morosos?cedula=1712345678' \ --header 'Authorization: Bearer {API_KEY}'200 OKapplication/json
trueEl contacto tiene deuda vencida.
200 OKapplication/json
falseEl contacto no tiene deuda vencida o no fue encontrado.
Respuestas claras
Respuestas y errores
Códigos esenciales para gestionar cada solicitud.
Consulta exitosa
La respuesta contiene true o false.
Solicitud inválida
Falta la cédula o el correo.
Credencial inválida
API key ausente, inválida o revocada.
Error interno
No fue posible procesar la consulta.
Los errores utilizan una respuesta JSON con un mensaje descriptivo y, cuando corresponde, el detalle por campo.
Empieza tu integración
¿Necesitas acceso?
Las credenciales de integración son gestionadas directamente por el equipo de Habitanto.
Comunícate con el equipo de HabitantoTe ayudaremos a solicitar y gestionar el acceso.