# 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 →](https://docs.lunasalud.mx/es) [Explorar endpoints](https://www.lunasalud.mx/clinical-api-emr#endpoints) 8+ Endpoints REST JSON Respuestas limpias y paginadas Webhooks Eventos en tiempo real **Webhook recibido** Nuevo resultado de laboratorio ```bash # Consulta las citas de tu organización curl https://account.lunahealth.app/api/appointments \ -H "Authorization: Bearer TU_LLAVE_DE_API" ``` ```json { "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 →](https://docs.lunasalud.mx/es) ## 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. 1. **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. 2. **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. 3. **Consulta y automatiza** Llama a cualquier endpoint, pagina con `page` y `rowsPerPage`, y suscríbete a webhooks para reaccionar en tiempo real. ejemplo — biomarcadores ```bash # 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" ``` ```json { "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. [Ver documentación →](https://docs.lunasalud.mx/es)