Accede a la informacion de tu cuenta con la API de Luna Salud
La API de Luna Salud te permite consultar la informacion de tu cuenta de forma programatica. Con tus llaves de acceso puedes conectar Luna Salud con tus propias herramientas de reportes, dashboards de analisis o cualquier sistema que necesite leer datos de tu organizacion. La API es de solo lectura: te permite consultar informacion pero no crear ni modificar registros.
¿Para que sirve la API?
La API te da acceso directo a la informacion de tu cuenta para que puedas usarla fuera de Luna Salud. Algunos ejemplos:
Reportes personalizados
Crea reportes a la medida de tu clinica conectando los datos de Luna Salud con herramientas como Google Sheets, Excel o Power BI.
Dashboards de analisis
Construye dashboards en tiempo real con las metricas de citas, pacientes e ingresos de tu organizacion.
Integraciones con otros sistemas
Conecta Luna Salud con tu sistema contable, CRM o cualquier otra plataforma que necesite leer datos de tu consultorio.
Seguimiento de laboratorios
Consulta resultados de laboratorio y biomarcadores de tus pacientes para alimentar sistemas de monitoreo clinico.
Como activar tus llaves de API
Para empezar a usar la API necesitas obtener tus llaves de acceso. Sigue estos pasos:
Inicia sesion en tu cuenta
Entra a account.lunahealth.app con tu usuario y contrasena. Necesitas tener rol de Administrador para acceder a las llaves de API.
Ve a la seccion de API
Navega a Configuracion y busca la seccion de API o Integraciones. Ahi encontraras tus llaves de acceso.
Copia tu llave de API
Tu llave de API (API Key) es un codigo unico que identifica a tu organizacion. Copiala y guardala en un lugar seguro.
Listo para usar
Con tu llave de API puedes empezar a hacer solicitudes a los endpoints disponibles. Incluye tu llave en el encabezado Authorization de cada solicitud.
Seguridad de tu llave de API
Tu llave de API da acceso a la informacion de tu organizacion. Guardala solo en el servidor de tu aplicacion (nunca en el codigo del navegador o en apps moviles). Si crees que tu llave fue comprometida, puedes regenerarla desde la configuracion de tu cuenta.
Como autenticarte
Todas las solicitudes a la API requieren autenticacion. Incluye tu llave de API en el encabezado Authorization con el prefijo Bearer:
# Ejemplo de solicitud con autenticacion
curl https://account.lunahealth.app/api/patients \
-H "Authorization: Bearer TU_LLAVE_DE_API"
La URL base para todas las solicitudes es:
https://account.lunahealth.app/api
Endpoints disponibles
La API ofrece los siguientes endpoints para consultar informacion de tu cuenta. Todos los endpoints son de solo lectura (metodo GET).
Consulta la lista de citas de tu organizacion. Puedes filtrar por rango de fechas, estado de la cita (nueva, confirmada, completada, cancelada) y por paciente.
Obtiene la lista de pacientes de tu organizacion. Puedes buscar por nombre y filtrar por estatus activo o inactivo.
Obtiene el perfil de un paciente especifico por su ID: nombre, correo y datos basicos.
Recupera las notas clinicas y el expediente estructurado de un paciente: consultas, signos vitales, alergias, diagnosticos y procedimientos.
Consulta los biomarcadores de un paciente con filtros por fecha y estado (optimo, aceptable, critico, en verificacion).
Obtiene la lista de estudios de laboratorio de un paciente, incluyendo nombre del estudio, fecha y cantidad de biomarcadores asociados.
Consulta todos los biomarcadores asociados a un estudio de laboratorio especifico, incluyendo valores, unidades y rangos de referencia.
Consulta la configuracion de webhooks de tu organizacion: URL destino, eventos suscritos y estado de activacion.
Documentacion tecnica completa
Para ver todos los parametros, ejemplos de respuesta y detalles tecnicos de cada endpoint, visita la documentacion completa en docs.lunasalud.mx
Ejemplo: consultar tus citas
Este es un ejemplo de como consultar las citas de tu organizacion filtradas por fecha:
# Consultar citas de junio 2026
curl "https://account.lunahealth.app/api/appointments?from=2026-06-01T00:00:00Z&to=2026-06-30T23:59:59Z&rowsPerPage=50&page=0" \
-H "Authorization: Bearer TU_LLAVE_DE_API"
La respuesta incluye la lista de citas con sus detalles:
{
"items": [
{
"id": "abc123",
"status": "CONFIRMED",
"title": "Consulta general",
"start_time": "2026-06-15T10:00:00Z",
"end_time": "2026-06-15T10:30:00Z",
"patient": {
"id": "pat456",
"first_name": "Maria",
"last_name": "Garcia"
},
"service": { "name": "Consulta general" }
}
],
"meta": { "total": 42, "page": 0, "rowsPerPage": 50 }
}
Ejemplo: consultar el expediente de un paciente
Puedes obtener las notas clinicas y el expediente estructurado de un paciente especifico:
# Consultar notas clinicas de un paciente
curl "https://account.lunahealth.app/api/patient-charts?patientId=pat456" \
-H "Authorization: Bearer TU_LLAVE_DE_API"
Ejemplo: consultar biomarcadores
Consulta los biomarcadores de un paciente, con filtros opcionales por fecha y estado:
# Consultar biomarcadores criticos de un paciente
curl "https://account.lunahealth.app/api/biomarkers?patientId=pat456&status=CRITICAL" \
-H "Authorization: Bearer TU_LLAVE_DE_API"
Webhooks: notificaciones automaticas
Ademas de consultar informacion, puedes configurar webhooks para recibir notificaciones automaticas cuando se actualicen datos en tu cuenta. Por ejemplo, puedes recibir una notificacion cada vez que se suban nuevos resultados de laboratorio o biomarcadores.
Resultados de laboratorio: Recibe una notificacion cada vez que se suba un nuevo estudio de laboratorio a un expediente de paciente.
Biomarcadores: Recibe una notificacion cuando se actualicen los valores de biomarcadores de un paciente.
Consulta la configuracion actual de tus webhooks con el endpoint /webhooks/config.
Consideraciones importantes
Solo lectura: La API es de solo lectura. Puedes consultar datos pero no puedes crear, modificar ni eliminar registros a traves de ella.
Seguridad: Tu llave de API es equivalente a una contrasena. Guardala en un lugar seguro y nunca la expongas en codigo del lado del cliente (navegador o app movil).
Acceso por organizacion: Tu llave de API da acceso a la informacion de toda tu organizacion. Solo los administradores pueden ver y regenerar las llaves.
Paginacion: Los endpoints que devuelven listas soportan paginacion. Usa los parametros page y rowsPerPage (o limit) para controlar cuantos resultados recibes por solicitud.
Comienza a usar la API
Consulta la documentacion tecnica completa con todos los parametros, respuestas y ejemplos.
