Construya sobre Mira™.
API REST + webhooks para agencias que quieran integrar Mira™ en su stack. Cumple con HIPAA, listo para SSO, protegido con OAuth2.
Qué puede hacer
La API de Mira™ expone las mismas superficies que su personal usa en el portal, totalmente programables para que pueda incorporar la inteligencia de facturación directamente en su EHR, sistema de gestión de agencia o flujo de trabajo personalizado.
Sincronización de pacientes
Cree, actualice y consulte datos demográficos de pacientes, cobertura de seguro y metadatos del plan de cuidado en tiempo real.
Envío de reclamaciones
Envíe reclamaciones profesionales e institucionales, adjunte datos de encuentros y consulte el estado de adjudicación del pagador.
Eventos webhook
Suscríbase a cambios de estado de reclamaciones, alertas de denegación, publicaciones de pago y actualizaciones de registros de pacientes mediante webhooks HTTP firmados.
Endpoints de funciones IA
Active la puntuación de predicción de denegaciones, codificación asistida por IA, generación de resúmenes IDG y detección de anomalías de auditoría desde sus propios flujos de trabajo.
Inicio rápido
Aviso sobre el hostname: Los ejemplos de la API
referencian api.usemirahealth.com;
el host de la API migrará de api.cpsbilling.*
en una entrega separada. Las integraciones existentes no se ven
afectadas.
1. Obtenga una clave de API
Vaya a Portal → Configuración → API Keys para
crear una nueva clave. Las claves tienen el prefijo mira_sk_
y se muestran en su totalidad solo una vez. Guárdelas en un
gestor de secretos.
2. Primera solicitud — sincronizar paciente (curl)
Los ejemplos de código se muestran en inglés (estándar del sector).
curl -X GET https://api.usemirahealth.com/v2/patients \
-H "Authorization: Bearer mira_sk_a1b2c3d4e5f6..." \
-H "Content-Type: application/json"3. Enviar una reclamación (curl)
curl -X POST https://api.usemirahealth.com/v2/claims \
-H "Authorization: Bearer mira_sk_a1b2c3d4e5f6..." \
-H "Content-Type: application/json" \
-d '{
"patientId": "pat_01HXZ9R...",
"encounterId": "enc_01HXZ9S...",
"billingCodes": ["99213", "Z79.899"],
"diagnosisCodes": ["E11.9"]
}'4. Uso del SDK de JavaScript
Instale el SDK con npm install @mira-ai/sdk,
luego:
import { MiraClient } from '@mira-ai/sdk';
const mira = new MiraClient({ apiKey: process.env.MIRA_API_KEY });
// Sync a patient
const patient = await mira.patients.create({
firstName: 'Jane',
lastName: 'Doe',
dob: '1980-04-15',
mrn: 'MRN-00123',
});
// Submit a claim
const claim = await mira.claims.submit({
patientId: patient.id,
encounterId: 'enc_01HXZ9S...',
billingCodes: ['99213'],
});
console.log('Claim ID:', claim.id);5. Eventos webhook
Registre un endpoint HTTPS en Portal → Webhooks.
Mira™ firma cada entrega con un encabezado Mira-Signature
(HMAC-SHA256). Ejemplo de payload:
POST https://your-endpoint.example.com/webhooks/mira
Content-Type: application/json
Mira-Signature: sha256=...
{
"event": "claim.status_changed",
"timestamp": "2026-06-09T14:22:00Z",
"data": {
"claimId": "clm_01HXZ9T...",
"previousStatus": "submitted",
"newStatus": "approved",
"payer": "Medicare"
}
}Descripción general de Auth + SSO
Claves de API
Secretos de larga duración para integraciones servidor a servidor.
Con alcance de read, write o admin.
Puede rotarlas en cualquier momento desde el portal.
OAuth 2.0
Flujo de código de autorización para acceso delegado por el usuario. Tokens de acceso de corta duración (15 min) + tokens de actualización (30 días). Compatible con PKCE para clientes públicos.
SSO / SAML
SSO empresarial mediante Azure AD B2C + federación SAML 2.0. El personal se autentica a través de su IdP existente, sin contraseña separada de Mira™. Aprovisionamiento SCIM disponible en planes Enterprise.
Flujo de autorización OAuth 2.0
Los ejemplos de código se muestran en inglés (estándar del sector).
# 1. Redirect user to authorization
GET https://auth.usemirahealth.com/oauth2/authorize
?response_type=code
&client_id=YOUR_CLIENT_ID
&redirect_uri=https://your-app.com/callback
&scope=claims:read+claims:write+patients:read
&state=RANDOM_STATE_TOKEN
# 2. Exchange code for tokens
POST https://auth.usemirahealth.com/oauth2/token
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code
&code=AUTH_CODE
&redirect_uri=https://your-app.com/callback
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRETCumplimiento HIPAA
Todo el tráfico de la API está cifrado en tránsito con TLS 1.2+. Los PHI en reposo usan AES-256. Mira™ opera como Socio Comercial bajo HIPAA: hay un BAA disponible para todos los planes de pago. Los registros de auditoría de la API son inmutables y se conservan durante 7 años.
Referencia de la API y documentación OpenAPI
La superficie completa de la API está descrita en una especificación OpenAPI 3.1. Úsela para generar bibliotecas de cliente con tipos, importarla en Postman / Insomnia o impulsar sus propias herramientas.
Especificación OpenAPI 3.1 legible por máquina — impórtela en cualquier herramienta.
Documentación interactiva — explore y pruebe cada endpoint en el navegador.
| Alcance de clave de API | Permisos |
|---|---|
| read | Acceso de solo lectura a todos los endpoints |
| write | Acceso de lectura + creación/actualización |
| admin | Acceso completo, incluida la gestión de webhooks y SSO |
¿Listo para construir?
Cree una clave de API en el portal y empiece a integrar en minutos. ¿Preguntas? Nuestro equipo de soporte para desarrolladores está a un mensaje.