Luma Health

Luma Health is a United States patient-engagement (Patient Success) platform for healthcare provider organizations, headquartered in San Francisco, California. Its operational AI platform automates the patient journey - self-service scheduling and appointment management, referral and waitlist management, intake and digital forms, omnichannel two-way messaging and broadcast, appointment reminders and recalls, insurance eligibility verification, payments and billing, and a conversational AI assistant (Navigator / lumabot) - and integrates bidirectionally with the major EHRs (Epic, Oracle Health/Cerner, MEDITECH, eClinicalWorks, athenahealth, NextGen, Greenway, Nextech). Luma exposes a documented public REST API (Rest-Service v2.0.0, OpenAPI 3.0.0) at https://api.lumahealth.io/api/v2, secured with OAuth2 client-credentials that issue JWT bearer tokens. The developer-facing surface is a REST API rather than an HL7 FHIR server; FHIR/HL7 interoperability with EHRs happens inside Luma's integration layer, not as a public FHIR endpoint.

Luma Health publishes 13 APIs on the APIs.io network, including Scheduling & Appointments API, Patients API, Providers & Facilities API, and 10 more. Tagged areas include Healthcare, United States, Patient Engagement, Scheduling, and Referrals.

Luma Health’s developer surface includes authentication, documentation, API reference, engineering blog, and 32 more developer resources.

🌐 Visit website 📡 Source on GitHub

49.2/100 developing ▬ flat Agent 40/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

13 APIs 1 MCP Servers

Healthcare United States Patient Engagement Scheduling Referrals Intake Messaging Eligibility EHR Interoperability Clinical AI Reputation ManagementPatient Feedback

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 49.2/100 · developing

Contract Quality 11.3 / 21

Developer Ergonomics 7.2 / 17

Access Clarity 7.4 / 17

Operational Transparency 3.2 / 11

Contract Governance 1.7 / 10

Discoverability 6.9 / 9

Regulatory Posture 7.7 / 15

Agent readiness — 40/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Regulatory Posture applies to this provider. Its tags matched the Health regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/luma-health: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 13

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Get Started 2

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

Login

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

OpenAPI

OpenAPI

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

MCPServer

LLMsTxt

AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conformance

ErrorCatalog

Lifecycle

Conventions

DataModel

Build 2

SDKs, sample code, and the tooling you integrate with

Packages

Packages

GitHubOrganization

GitHubOrganization

Access & Security 6

Authentication, authorization, and security posture

DomainSecurity

Authentication

Compliance

TrustCenter

VulnerabilityDisclosure

VulnerabilityDisclosure

Security

Security

Learn 1

Tutorials, courses, talks, and written guidance

Learn

Learn

Operate 3

Status, limits, changes, and where to get help

RateLimits

RateLimits

HelpCenter

HelpCenter

StatusPage

StatusPage

Commercial 3

Pricing, plans, and the legal terms of use

Plans

Plans

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 6

The organization behind the API

Website

Blog

BlogRSS

Newsroom

Careers

LinkedIn

Other 1

Properties that don't map to a standard resource type

Overlay

Overlay

Source (apis.yml)

aid: luma-health
url: https://raw.githubusercontent.com/api-evangelist/luma-health/refs/heads/main/apis.yml
name: Luma Health
kind: company
description: Luma Health is a United States patient-engagement (Patient Success) platform for healthcare provider organizations,
  headquartered in San Francisco, California. Its operational AI platform automates the patient journey - self-service scheduling
  and appointment management, referral and waitlist management, intake and digital forms, omnichannel two-way messaging and
  broadcast, appointment reminders and recalls, insurance eligibility verification, payments and billing, and a conversational
  AI assistant (Navigator / lumabot) - and integrates bidirectionally with the major EHRs (Epic, Oracle Health/Cerner, MEDITECH,
  eClinicalWorks, athenahealth, NextGen, Greenway, Nextech). Luma exposes a documented public REST API (Rest-Service v2.0.0,
  OpenAPI 3.0.0) at https://api.lumahealth.io/api/v2, secured with OAuth2 client-credentials that issue JWT bearer tokens.
  The developer-facing surface is a REST API rather than an HL7 FHIR server; FHIR/HL7 interoperability with EHRs happens inside
  Luma's integration layer, not as a public FHIR endpoint.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Healthcare
- United States
- Patient Engagement
- Scheduling
- Referrals
- Intake
- Messaging
- Eligibility
- EHR
- Interoperability
- Clinical AI
- Reputation Management
- Patient Feedback
created: '2026-07-24'
modified: '2026-08-15'
specificationVersion: '0.23'
apis:
- aid: luma-health:luma-health-scheduling-api
  name: Luma Health Scheduling & Appointments API
  description: Self-service scheduling, appointment lifecycle, appointment types, provider availabilities, schedulers, offers,
    recalls, and waitlist management.
  humanURL: https://apidocs.lumahealth.io/#tag/appointments
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Scheduling
  - Appointments
  - Availabilities
  - Waitlists
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/appointments
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-patients-api
  name: Luma Health Patients API
  description: Patient demographics and records, patient forms and form templates, and patient stored credit cards.
  humanURL: https://apidocs.lumahealth.io/#tag/patients
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Patients
  - Forms
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/patients
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-providers-facilities-api
  name: Luma Health Providers & Facilities API
  description: Providers, provider scheduling groups, facilities, specialties, groups, and platform users.
  humanURL: https://apidocs.lumahealth.io/#tag/providers
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Providers
  - Facilities
  - Specialties
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/providers
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-messaging-api
  name: Luma Health Messaging & Engagement API
  description: Two-way patient messaging, engagements and engagement events/settings, appointment reminders, and patient message
    templates.
  humanURL: https://apidocs.lumahealth.io/#tag/messages
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Messaging
  - Engagement
  - Reminders
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/messages
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-broadcast-api
  name: Luma Health Broadcast & Campaigns API
  description: Broadcast events, broadcast flows and templates, and outreach campaigns for population-level patient messaging.
  humanURL: https://apidocs.lumahealth.io/#tag/broadcastFlows
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Broadcast
  - Campaigns
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/broadcastFlows
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-intake-forms-api
  name: Luma Health Intake & Forms API
  description: Digital intake via checklists and checklist templates, patient forms and form templates, and file uploads.
  humanURL: https://apidocs.lumahealth.io/#tag/checklists
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Intake
  - Forms
  - Checklists
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/checklists
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-billing-payments-api
  name: Luma Health Billing & Payments API
  description: Billing charges and copays, cost estimates, and patient credit-card payment instruments.
  humanURL: https://apidocs.lumahealth.io/#tag/billingCharges
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Billing
  - Payments
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/billingCharges
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-eligibility-insurance-api
  name: Luma Health Eligibility & Insurance API
  description: Insurance records with real-time eligibility verification and the insurance payors directory.
  humanURL: https://apidocs.lumahealth.io/#tag/insurances
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Eligibility
  - Insurance
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/insurances
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-referrals-api
  name: Luma Health Referrals API
  description: Inbound and outbound referral management across the care network.
  humanURL: https://apidocs.lumahealth.io/#tag/referrals
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Referrals
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/referrals
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-feedback-reputation-api
  name: Luma Health Feedback & Reputation API
  description: NPS survey responses and feedback-link clicks, external reviews scraped from Google Business Profile and Yelp
    with AI-extracted sentiment and themes, AI-drafted public review replies with an approve/reject workflow, and per-patient
    review-platform rotation history.
  humanURL: https://apidocs.lumahealth.io/#tag/feedbackResponses
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Feedback
  - Reputation
  - Reviews
  - NPS
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/feedbackResponses
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
  - type: AgentSkill
    url: skills/luma-health-manage-patient-feedback.md
- aid: luma-health:luma-health-assistant-api
  name: Luma Health Conversational AI Assistant API
  description: Conversational AI assistant surfaces - assistant instances and actions, lumabot flows and templates, knowledge-base
    question/answers, chat activities, and queue-manager routing.
  humanURL: https://apidocs.lumahealth.io/#tag/assistantInstances
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Clinical AI
  - Assistant
  - Chat
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/assistantInstances
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-reporting-api
  name: Luma Health Reporting & Audits API
  description: Operational reports plus system and chat audit trails.
  humanURL: https://apidocs.lumahealth.io/#tag/reports
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Reporting
  - Audits
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/reports
  - type: Authentication
    url: https://apidocs.lumahealth.io/#tag/auth
- aid: luma-health:luma-health-authentication-api
  name: Luma Health Authentication API
  description: OAuth2 client-credentials authentication - generate and rotate client id/secret and exchange them for JWT access
    tokens (including subaccount tokens).
  humanURL: https://apidocs.lumahealth.io/#tag/auth
  baseURL: https://api.lumahealth.io/api/v2
  tags:
  - Authentication
  tags_raw:
  - Authentication
  - OAuth2
  properties:
  - type: OpenAPI
    url: openapi/luma-health-openapi.yaml
  - type: Documentation
    url: https://apidocs.lumahealth.io
  - type: APIReference
    url: https://apidocs.lumahealth.io/#tag/auth
common:
- type: AgenticAccess
  url: agentic-access/luma-health-agentic-access.yml
- type: DomainSecurity
  url: security/luma-health-domain-security.yml
- type: Authentication
  url: authentication/luma-health-authentication.yml
- type: Conformance
  url: conformance/luma-health-conformance.yml
- type: Compliance
  url: https://www.lumahealth.io/security-and-trust/
- type: TrustCenter
  url: security/luma-health-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/luma-health-vulnerability-disclosure.yml
- type: Packages
  url: packages/luma-health-packages.yml
- type: Plans
  url: plans/luma-health-plans-pricing.yml
- type: RateLimits
  url: rate-limits/luma-health-rate-limits.yml
- type: ErrorCatalog
  url: errors/luma-health-problem-types.yml
- type: Lifecycle
  url: lifecycle/luma-health-lifecycle.yml
- type: Conventions
  url: conventions/luma-health-conventions.yml
- type: DataModel
  url: data-model/luma-health-data-model.yml
- type: MCPServer
  url: mcp/luma-health-mcp.yml
- type: LLMsTxt
  url: llms/luma-health-llms.txt
- type: Overlay
  url: overlays/luma-health-openapi-overlay.yaml
- type: AgentSkill
  url: skills/_index.yml
- type: Website
  url: https://www.lumahealth.io
- type: DeveloperPortal
  url: https://apidocs.lumahealth.io
- type: Documentation
  url: https://apidocs.lumahealth.io
- type: APIReference
  url: https://apidocs.lumahealth.io
- type: OpenAPI
  url: openapi/luma-health-openapi.yaml
- type: Integrations
  url: https://www.lumahealth.io/integrations-2
- type: Blog
  url: https://www.lumahealth.io/blog
- type: BlogRSS
  url: https://www.lumahealth.io/blog/feed/
- type: Learn
  url: https://www.lumahealth.io/learn
- type: HelpCenter
  url: https://support.lumahealth.io/hc/en-us
- type: Newsroom
  url: https://www.lumahealth.io/newsroom/in-the-news/
- type: Careers
  url: https://job-boards.greenhouse.io/lumahealth
- type: StatusPage
  url: https://status.lumahealth.io
- type: Security
  url: security/luma-health-vulnerability-disclosure.yml
- type: Login
  url: https://next.lumahealth.io/login
- type: TermsOfService
  url: https://www.lumahealth.io/terms-of-use
- type: PrivacyPolicy
  url: https://www.lumahealth.io/privacy-policy
- type: GitHubOrganization
  url: https://github.com/lumahealthhq
- type: LinkedIn
  url: https://www.linkedin.com/company/luma-health
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-enrichment:
  date: '2026-08-15'
  status: enriched
  artifacts_added: 5
  pass: local-v1