API de Luna Salud · Para desarrolladores

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.

8+
Endpoints REST
JSON
Respuestas limpias y paginadas
Webhooks
Eventos en tiempo real
🔔
Webhook recibidoNuevo resultado de laboratorio
bash — api.lunasalud200 OK
# 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 }
}
🔒
AutenticadoBearer token · por organización

Conecta Luna Salud con las herramientas que tu equipo ya usa

📊 Power BI📗 Google Sheets📈 Looker Studio🧮 Excel⚡ Zapier · Make🤖 Agentes de IA🧾 Tu ERP / CRM
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 →

Empieza en minutos

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. 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. 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. 3

    Consulta y automatiza

    Llama a cualquier endpoint, pagina con page y rowsPerPage, y suscríbete a webhooks para reaccionar en tiempo real.

ejemplo — biomarcadores200 OK
# 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 }
}
Diseñada para desarrolladores

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.

Seguridad y Cumplimiento

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.

🔒
HIPAAManejo de información de salud conforme al estándar internacional
🇲🇽
NOM-004-SSA3Datos estructurados en línea con la norma mexicana del expediente clínico
🛡️
Cifrado AES-256Información cifrada en tránsito (TLS) y en reposo
🔑
Acceso controladoLlaves 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.

Cifrado AES-256HTTPS / TLSLlaves revocablesDatos en México
Preguntas Frecuentes

Todo sobre 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.

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.

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.

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.

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 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 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.

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.

✨ Disponible ahora

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.