aid: healthie
name: Healthie
description: Healthie is a cloud, API-first EHR and practice management platform purpose-built for digital health
  startups, virtual care companies, and modern clinical practices. Healthie packages an EHR, scheduling, charting,
  telehealth, intake forms, care plans, online programs, messaging, billing, claims (CMS-1500 / ClaimMD), and
  patient portal behind a single GraphQL API and modular SDKs that power both the Healthie product UI and partner
  applications. Healthie targets the digital health ecosystem with a "buy the EHR, build the experience" model
  — the same API that backs the Healthie web and mobile apps is fully exposed to customers building branded
  patient and provider experiences on top of the platform.
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/healthie/refs/heads/main/apis.yml
type: Index
kind: contract
access: 3rd-Party
position: Consumer
tags:
- API-First
- Appointments
- Billing
- Care Plans
- Charting
- Claims
- Clinical
- Digital Health
- EHR
- EMR
- Forms
- GraphQL
- Health Tech
- Healthcare
- Insurance
- Intake
- Online Programs
- Patient Engagement
- Patient Portal
- Practice Management
- Programs
- Scheduling
- Telehealth
- Wellness
- Webhooks
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.20'
apis:
- aid: healthie:healthie-graphql-api
  name: Healthie GraphQL API
  description: The Healthie GraphQL API is the single contract behind the entire Healthie platform — the same
    API that powers the Healthie web, iOS, and Android applications is available to partners building branded
    care experiences. The schema exposes clients, appointments, availability, charting notes, custom forms and
    form-answer groups, care plans, goals, allergies, immunizations, medications, diagnoses, lab orders, CMS-1500
    claims, insurance authorizations and eligibility checks, payments, online programs and courses, conversations,
    direct messaging, faxing, and announcements. Authentication is API-key based via `Authorization: Basic`
    + `AuthorizationSource: API` headers, with optional `AuthorizationShard` for sharded customers. Versioning
    is opt-in by date via the `Healthie-GraphQL-API-Version` header (current default version `2024-06-01`).
    Rate limits combine a dynamic per-account request rate with a per-query complexity score (max 2000) and
    depth limit (max 25). Sandbox is fully isolated at `https://staging-api.gethealthie.com/graphql`; production
    runs at `https://api.gethealthie.com/graphql`.
  image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
  humanURL: https://docs.gethealthie.com/
  baseURL: https://api.gethealthie.com/graphql
  tags:
  - Appointments
  - Billing
  - Charting
  - Claims
  - Clients
  - EHR
  - Forms
  - GraphQL
  - Healthcare
  - Insurance
  - Patients
  - Practice Management
  - Programs
  - Scheduling
  - Telehealth
  - Webhooks
  properties:
  - type: Documentation
    url: https://docs.gethealthie.com/
  - type: Documentation
    name: GraphQL Schema Reference
    url: https://docs.gethealthie.com/reference
  - type: Documentation
    name: Quickstart
    url: https://docs.gethealthie.com/guides/quickstart
  - type: Authentication
    url: https://docs.gethealthie.com/guides/api-concepts/authentication
  - type: Environments
    url: https://docs.gethealthie.com/guides/api-concepts/environments
  - type: Versioning
    url: https://docs.gethealthie.com/guides/api-concepts/versioning
  - type: RateLimits
    url: https://docs.gethealthie.com/guides/api-concepts/rate-limits
  - type: Webhooks
    url: https://docs.gethealthie.com/guides/webhooks
  - type: Sandbox
    name: Staging GraphQL Endpoint
    url: https://staging-api.gethealthie.com/graphql
  - type: GraphiQL
    url: https://docs.gethealthie.com/graphiql
common:
- type: Website
  url: https://www.gethealthie.com/
- type: Portal
  name: Healthie API & Platform
  url: https://www.gethealthie.com/api
- type: Documentation
  name: Healthie Developer Docs
  url: https://docs.gethealthie.com/
- type: Documentation
  name: GraphQL Schema Reference
  url: https://docs.gethealthie.com/reference
- type: GettingStarted
  url: https://docs.gethealthie.com/guides/quickstart
- type: Authentication
  url: https://docs.gethealthie.com/guides/api-concepts/authentication
- type: Versioning
  url: https://docs.gethealthie.com/guides/api-concepts/versioning
- type: RateLimits
  url: https://docs.gethealthie.com/guides/api-concepts/rate-limits
- type: Webhooks
  url: https://docs.gethealthie.com/guides/webhooks
- type: Environments
  url: https://docs.gethealthie.com/guides/api-concepts/environments
- type: SDK
  name: '@healthie/sdk (npm)'
  url: https://www.npmjs.com/org/healthie
- type: Tool
  name: Healthie Dev Assist (MCP)
  url: https://github.com/healthie/healthie-dev-assist
- type: CodeExamples
  name: Healthie Sample Booking Widget
  url: https://github.com/healthie/healthie_sample_booking_widget
- type: GitHubOrganization
  url: https://github.com/healthie
- type: LinkedIn
  url: https://www.linkedin.com/company/gethealthie/
- type: X
  url: https://x.com/gethealthie
- type: Blog
  url: https://www.gethealthie.com/blog
- type: StatusPage
  url: https://status.gethealthie.com/
- type: ChangeLog
  name: API Version History
  url: https://docs.gethealthie.com/guides/api-concepts/versioning
- type: Pricing
  url: https://www.gethealthie.com/pricing
- type: Plans
  url: https://www.gethealthie.com/pricing
  data:
  - id: core
    name: Core
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 19
      metric: user
      timeFrame: month
      description: Monthly billing.
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 18
      metric: user
      timeFrame: month
      description: Annual billing (saves 10%).
    elements:
    - name: 10 active clients
    - name: Scheduling
    - name: Payment processing
    - name: Charting
    - name: Telehealth
    - name: Client portal
    - name: Mobile app
    description: For clinicians needing basic practice tools.
  - id: essentials
    name: Essentials
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 49
      metric: user
      timeFrame: month
      description: Monthly billing.
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 45
      metric: user
      timeFrame: month
      description: Annual billing (saves 10%).
    elements:
    - name: 250 active clients
    - name: Free outbound fax
    - name: Custom forms
    - name: CMS-1500 claims
    - name: Group messaging
    - name: ClaimMD integration (starts at $30/mo)
    description: For clinicians starting and growing practices (most popular).
  - id: plus
    name: Plus
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 129
      metric: user
      timeFrame: month
      description: Monthly billing.
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 115
      metric: user
      timeFrame: month
      description: Annual billing (saves 10%).
    elements:
    - name: Unlimited clients
    - name: Group telehealth
    - name: Online programs
    - name: Dedicated eFax (inbound and outbound)
    description: For scaling practices.
  - id: group
    name: Group
    entries:
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 149
      metric: user
      timeFrame: month
      description: Monthly billing, starts at $149/mo.
    - geo: US
      unit: 1
      label: User
      limit: 1
      price: 135
      metric: user
      timeFrame: month
      description: Annual billing (saves 10%), starts at $135/mo.
    - geo: US
      unit: 1
      label: Additional Clinician
      limit: 1
      price: 50
      metric: user
      timeFrame: month
      description: Per additional team member.
    elements:
    - name: All Plus features
    - name: Shared calendar
    - name: Team member management
    - name: Roles and permissions
    - name: Internal chat
    - name: Color-coded calendar
    description: For multi-provider practices.
  - id: enterprise
    name: API & Enterprise
    entries:
    - geo: US
      unit: 1
      label: Contract
      limit: 1
      price: Call
      metric: contract
      timeFrame: year
      description: Custom enterprise pricing for digital-health builders and API-driven implementations.
    elements:
    - name: Full GraphQL API access
    - name: Modular SDKs (@healthie/sdk)
    - name: Webhooks
    - name: Sandbox environment
    - name: Sub-organizations and parent-org webhooks
    - name: Sharded data residency
    description: API-first plan for digital-health startups and enterprises building branded experiences on Healthie.
- type: Features
  data:
  - GraphQL API powering Healthie's own EHR, mobile, and patient portal — same contract for first-party and partners
  - Resources span clients, appointments, availability, charting, forms, programs, goals, allergies, immunizations,
    medications, lab orders, CMS-1500 claims, insurance authorizations, eligibility checks, payments, messaging,
    fax, conversations, and announcements
  - Date-based opt-in API versioning via the `Healthie-GraphQL-API-Version` header — default `2024-06-01`
  - API-key authentication via `Authorization: Basic` + `AuthorizationSource: API` (plus `AuthorizationShard` for sharded customers)
  - `createApiKey` GraphQL mutation for programmatic key issuance scoped to individual user accounts
  - Two-environment model — `staging-api.gethealthie.com` sandbox and `api.gethealthie.com` production with no data transfer between them
  - Query complexity scoring (max 2000) and 25-level depth limit instead of fixed RPS rate limits
  - HMAC-SHA256 signed webhooks with exponential-backoff retry up to 3 days, auto-disable, and email alerts
  - Webhook `resource_id_type` covers Appointment, FormAnswerGroup, Entry, and Note events with `changed_fields` deltas
  - Parent-organization webhooks aggregate events across sub-organizations
  - Modular TypeScript / JavaScript SDKs on npm under `@healthie/sdk`
  - Healthie Dev Assist — official MCP server for AI-assisted Healthie development
  - Sample Booking Widget reference implementation on GitHub
  - Healthie Harbor app marketplace with Google Fit, Apple Health, Fitbit, Stripe, Zoom, ClaimMD, Fullscript Labs,
    and Change Healthcare integrations
  - HIPAA and PCI compliant infrastructure operating ~2.5B API calls/month at 99.99% uptime
  - SMART on FHIR / interoperability and US-based data residency options for enterprise
  sources:
  - https://www.gethealthie.com/
  - https://www.gethealthie.com/api
  - https://docs.gethealthie.com/
  - https://docs.gethealthie.com/guides/api-concepts/authentication
  - https://docs.gethealthie.com/guides/api-concepts/versioning
  - https://docs.gethealthie.com/guides/api-concepts/rate-limits
  - https://docs.gethealthie.com/guides/api-concepts/environments
  - https://docs.gethealthie.com/guides/webhooks
  - https://www.gethealthie.com/pricing
  updated: '2026-05-25'
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com