API Médica de Luna Salud — Citas, Expediente Clínico, Laboratorio y Biomarcadores
La API médica para construir sobre tus datos clínicos.
Conecta citas, pacientes, expediente clínico, laboratorios y biomarcadores con tus propias herramientas, dashboards y agentes de IA. Una API REST segura con datos en tiempo real de tu organización.
Ver documentación → Explorar endpoints
8+
Endpoints REST
JSON
Respuestas limpias y paginadas
Webhooks
Eventos en tiempo real
Webhook recibido Nuevo resultado de laboratorio
# Consulta las citas de tu organización
curl https://account.lunahealth.app/api/appointments \
-H "Authorization: Bearer TU_LLAVE_DE_API"
{
"items": [\
{\
"id": "apt_8f2c",\
"status": "CONFIRMED",\
"start_time": "2026-07-24T10:00:00Z",\
"patient": { "first_name": "María" },\
"service": { "name": "Consulta general" }\
}\
],
"meta": { "total": 42, "page": 0 }
}
Autenticado Bearer token · por organización
Conecta Luna Salud con las herramientas que tu equipo ya usa
¿Qué puedes construir?
Convierte la información de tu clínica en decisiones
Lleva tus citas, pacientes y resultados clínicos a los reportes, dashboards y sistemas donde tu equipo toma decisiones, con datos siempre actualizados y sin trabajo manual.
Reportes a la medida
Alimenta Power BI, Looker Studio, Google Sheets o Excel con las métricas reales de tu clínica, siempre al día.
Dashboards en tiempo real
Construye tableros con citas, ocupación de agenda, pacientes e ingresos para dirección y operación.
Integraciones internas
Conecta Luna con tu sistema contable, CRM o ERP para que la información fluya sin capturas dobles.
Monitoreo clínico y de laboratorio
Sincroniza estudios, resultados y biomarcadores para vigilancia de pacientes crónicos o tableros de salud poblacional.
Agentes y copilotos de IA
Dale a tu asistente de IA acceso estructurado y seguro al expediente para respuestas fundamentadas en datos reales.
Portales y apps propias
Crea experiencias a la medida para pacientes o proveedores sobre la misma fuente de verdad de tu organización.
La superficie de la API
Endpoints REST para cada parte de tu clínica
Todos los endpoints devuelven JSON limpio y soportan paginación. Base URL: https://account.lunahealth.app/api
Agenda y citas
Consulta la actividad de tu agenda con filtros por fecha, estado y paciente.
GET/appointmentsLista de citas
Pacientes
Accede al directorio de pacientes de tu organización y al perfil individual de cada uno.
GET/patientsDirectorio
GET/patientPerfil por ID
Expediente clínico
Recupera notas clínicas y el expediente estructurado: consultas, signos vitales, alergias, diagnósticos y procedimientos.
GET/patient-chartsNotas y expediente
Laboratorio y biomarcadores
Consulta estudios de laboratorio y los biomarcadores de cada paciente, con valores, unidades y rangos de referencia.
GET/biomarkersBiomarcadores
GET/lab-testsEstudios
GET/lab-test-biomarkersDetalle por estudio
Webhooks
Recibe notificaciones automáticas cuando se suben nuevos resultados de laboratorio o se actualizan biomarcadores. Consulta tu configuración activa.
GET/webhooks/configConfiguración
Autenticación
Cada solicitud usa tu llave de API en el encabezado Authorization con el prefijo Bearer. Las llaves se activan desde la configuración de tu cuenta.
AUTHBearer TU_LLAVE_DE_APIPor organización
¿Buscas todos los parámetros y ejemplos de respuesta? Consulta la documentación técnica completa →
Tu primera petición en 3 pasos
Sin SDK obligatorio ni configuración compleja. Si tu lenguaje habla HTTP, ya puede hablar con Luna Salud.
- Activa tu llave de API
Un administrador la genera desde account.lunahealth.app, en Configuración → API. La llave da acceso a la información de toda tu organización.
- Autentícate con Bearer
Incluye la llave en el encabezado Authorization: Bearer … de cada solicitud. Guárdala solo en tu servidor, nunca en el navegador.
- Consulta y automatiza
Llama a cualquier endpoint, pagina con page y rowsPerPage, y suscríbete a webhooks para reaccionar en tiempo real.
ejemplo — biomarcadores
# Biomarcadores críticos de un paciente
curl "https://account.lunahealth.app/api/biomarkers?patientId=pat_456&status=CRITICAL" \
-H "Authorization: Bearer TU_LLAVE_DE_API"
{
"items": [\
{\
"name": "Glucosa en ayuno",\
"value": 148,\
"unit": "mg/dL",\
"status": "CRITICAL",\
"reference_range": "70-99"\
}\
],
"meta": { "total": 3, "rowsPerPage": 50 }
}
Estándar, predecible y segura por diseño
Sin sorpresas: REST sobre HTTPS, JSON limpio y una superficie predecible, acotada a los datos de tu organización.
REST estándar
HTTP + JSON sobre HTTPS. Compatible con cualquier lenguaje o plataforma, sin cliente propietario.
Respuestas limpias
JSON consistente con metadatos de paginación (page, rowsPerPage, total) en cada lista.
Siempre al día
Consulta la información más reciente de tu organización cuando la necesites, sin exportaciones ni copias desactualizadas.
Acotada por organización
Tu llave solo ve los datos de tu organización. El aislamiento de datos viene de fábrica.
Tiempo real con webhooks
Recibe eventos de laboratorio y biomarcadores en cuanto ocurren, en lugar de consultar en bucle.
Documentación completa
Parámetros, ejemplos y respuestas detalladas en docs.lunasalud.mx para arrancar sin fricción.
Datos de salud protegidos desde el diseño
La API se apoya en la misma infraestructura de seguridad de Luna Salud, con los estándares que exige el sector salud en México e internacionalmente.
HIPAA Manejo de información de salud conforme al estándar internacional
NOM-004-SSA3 Datos estructurados en línea con la norma mexicana del expediente clínico
Cifrado AES-256 Información cifrada en tránsito (TLS) y en reposo
Acceso controlado Llaves por organización, regenerables, solo para administradores
Tu información, bajo tu control
Los datos de tus pacientes son de tu organización. Las llaves de API se administran y revocan desde tu cuenta cuando lo necesites.
Todo sobre la API de Luna Salud
¿Qué es la API de Luna Salud?
Es una API REST que te permite consultar de forma programática la información de tu cuenta de Luna Salud: citas, pacientes, expediente clínico, estudios de laboratorio y biomarcadores. Está pensada para clínicas, laboratorios y desarrolladores en México que quieren conectar sus datos médicos con reportes, dashboards, otros sistemas o agentes de IA.
¿Qué puedo hacer con la API?
Puedes construir reportes y dashboards en tiempo real (Power BI, Looker Studio, Google Sheets, Excel), integrar Luna con tu sistema contable, CRM o ERP, monitorear resultados de laboratorio y biomarcadores, y darle a un agente o copiloto de IA acceso estructurado al expediente para respuestas fundamentadas.
¿Cómo obtengo una llave de API?
Un usuario con rol de administrador la genera desde account.lunahealth.app, en la sección de Configuración → API o Integraciones. La llave identifica a tu organización y se incluye en el encabezado Authorization: Bearer de cada solicitud. Puedes regenerarla en cualquier momento si crees que fue comprometida.
¿Qué endpoints están disponibles?
Los endpoints principales son /appointments (citas), /patients y /patient (pacientes), /patient-charts (expediente clínico), /biomarkers, /lab-tests y /lab-test-biomarkers (laboratorio y biomarcadores) y /webhooks/config (webhooks). Todos devuelven JSON paginado.
¿Tiene webhooks para notificaciones en tiempo real?
Sí. Puedes configurar webhooks para recibir una notificación automática cada vez que se sube un nuevo resultado de laboratorio o se actualizan los biomarcadores de un paciente, en lugar de consultar la API en bucle. Consulta tu configuración con el endpoint /webhooks/config.
¿Con qué lenguajes y herramientas funciona?
Con cualquiera que pueda hacer una solicitud HTTP: JavaScript/Node, Python, PHP, Go, Java y más. También puedes conectarla sin código a través de plataformas como Zapier o Make, o directo a herramientas de BI como Power BI, Looker Studio y Google Sheets.
¿La API es segura y cumple con la normativa?
La API usa autenticación por llave (Bearer), cifrado AES-256 en tránsito y en reposo, y acceso acotado a los datos de tu organización. Se apoya en la infraestructura de Luna Salud, alineada con HIPAA y la NOM-004-SSA3 del expediente clínico. Tu llave debe tratarse como una contraseña y guardarse solo del lado del servidor.
¿Dónde encuentro la documentación técnica?
La documentación completa, con todos los parámetros, ejemplos de solicitud y respuestas, está en docs.lunasalud.mx/es. Ahí encuentras el detalle de cada endpoint y cómo autenticarte.
Empieza a construir con la API de Luna Salud
Activa tu llave de acceso, revisa la documentación y conecta tus datos clínicos con las herramientas que tu equipo ya usa.