API & Integrations

Build Anything with Our Developer-First APIs

200+ RESTful endpoints, FHIR R4 capable integrations, comprehensive SDKs, and real-time webhooks. Everything developers need to build healthcare applications.

Read the DocsTry in Sandbox
Quick Start

Up and Running in Minutes

Install our SDK, authenticate with your API key, and start building. Our comprehensive documentation and sandbox environment make it easy to get started.

1

Install the SDK

Choose your language and install via your package manager.

2

Authenticate

Use your API key or OAuth 2.0 for secure access.

3

Make Your First Call

Query patient data, create encounters, or schedule appointments.

4

Go Live

Switch from sandbox to production when you're ready.

install.sh
# Install the Health SDK
npm install @health/sdk

# Or with yarn
yarn add @health/sdk

# Or with pip for Python
pip install health-sdk
quickstart.ts
import { Health } from '@health/sdk';

const client = new Health({
  apiKey: process.env.HEALTH_API_KEY,
  environment: 'sandbox', // or 'production'
});

// Fetch a patient by MRN
const patient = await client.patients.get({
  identifier: 'MRN-2024-001'
});

console.log(patient.name); // { given: "Jane", family: "Doe" }

// Create a health encounter
const encounter = await client.encounters.create({
  patient: patient.id,
  type: 'health',
  provider: 'dr-smith-001',
  scheduledStart: new Date('2026-04-01T10:00:00Z'),
});
API Reference

200+ Endpoints Across 6 Domains

Comprehensive APIs covering every aspect of healthcare operations, from patient records to billing.

45+ endpoints

Patient Records

Complete CRUD operations for patient demographics, medical history, allergies, medications, and clinical documents.

35+ endpoints

Clinical Workflows

Encounter management, clinical notes, orders, results, and care plan APIs for seamless clinical operations.

25+ endpoints

Scheduling

Appointment booking, provider availability, resource management, and automated reminder APIs.

50+ events

Webhooks & Events

Real-time event notifications for patient updates, appointment changes, lab results, and clinical alerts.

30+ endpoints

Interoperability

FHIR R4 resources, CDA document exchange, HL7v2 messaging, and X12 transaction support.

20+ endpoints

Identity & Access

OAuth 2.0, SMART on FHIR, user management, role-based access, and audit trail APIs.

SDKs & Libraries

Official SDKs in Your Language

Type-safe, well-documented SDKs that handle authentication, pagination, error handling, and retries.

JavaScript/TypeScript

v3.2.1

Python

v2.8.0

Java

v2.5.3

C# / .NET

v2.1.0

Ruby

v1.9.2

Go

v1.7.0
Real-Time Events

Webhooks That Keep You in Sync

Subscribe to 50+ event types and receive real-time notifications. Automatic retries, signature verification, and event replay built in.

patient.created / patient.updated
encounter.started / encounter.completed
lab_result.received / lab_result.reviewed
appointment.scheduled / appointment.cancelled
prescription.sent / prescription.filled
claim.submitted / claim.adjudicated
webhook-handler.ts
import { Health } from '@health/sdk';

const agen = new Health({
  apiKey: process.env.HEALTH_API_KEY,
  webhookSecret: process.env.WEBHOOK_SECRET,
});

// Express webhook handler
app.post('/webhooks/health', (req, res) => {
  const event = agen.webhooks.verify(
    req.body,
    req.headers['x-health-signature']
  );

  switch (event.type) {
    case 'patient.updated':
      syncPatientRecord(event.data);
      break;
    case 'lab_result.received':
      notifyProvider(event.data);
      break;
    case 'encounter.completed':
      generateEncounterSummary(event.data);
      break;
  }

  res.status(200).json({ received: true });
});
Developer Experience

Built by Developers, for Developers

Interactive Docs

Try every endpoint directly in the browser with our interactive API explorer.

Sandbox Environment

Full-featured sandbox with synthetic data for safe testing and development.

Version Control

Semantic versioning with 12-month deprecation windows. No surprise breaking changes.

99.99% Uptime

Enterprise SLA with real-time status page and proactive incident communication.

Start Building Today

Get your API keys and start building in our sandbox environment. No commitment required.

Get API KeysRead Documentation