Medplum (medplum)

Medplum is an Apache 2.0 open-source, FHIR-native developer platform for shipping clinical software. It bundles a FHIR R4 datastore, REST and GraphQL APIs, a TypeScript SDK, React component library, OAuth 2.0 / SMART on FHIR authentication, declarative Access Policies, Subscriptions, and TypeScript-based serverless Bots — sold as a hosted service at api.medplum.com and as a self-hostable monorepo on GitHub. Medplum is HIPAA, SOC 2 Type II, and ONC-certified.

URL: Visit APIs.json URL

Scope

• Type: Index
• License: Apache 2.0
• Governance: Medplum Inc. (commercial-open-source)
• Primary Language: TypeScript

Tags

Healthcare, FHIR, Open Source, Developer Platform, HIPAA, SMART on FHIR, Clinical, Interoperability

Timestamps

• Created: 2026-05-25
• Modified: 2026-05-25

APIs

Medplum FHIR REST API

FHIR R4 REST API exposed at https://api.medplum.com/fhir/R4. Supports the full generic FHIR resource surface — create, read, update, patch, delete, search, history, and version-read — across every FHIR R4 resource type, with US Core, SMART App Launch, and Bulk Data 2.0 conformance.

• Human URL: https://www.medplum.com/docs/api
• Base URL: https://api.medplum.com/fhir/R4

Properties

• Documentation
• APIReference
• OpenAPI
• Authentication
• RateLimits
• JSON Schema: Patient, Observation, Encounter, Practitioner, Organization, Condition, MedicationRequest, Subscription
• JSON Structure: Patient
• Examples: Create Patient, Blood Pressure Observation, Subscription Webhook
• Naftiko Capability: medplum-fhir-rest.yaml

Medplum GraphQL API

FHIR-aware GraphQL endpoint at https://api.medplum.com/fhir/R4/$graphql. Supports typed nested queries, reverse-reference traversal (_reference), FHIRPath-style array filtering, and access-policy enforcement at the field level.

• Human URL: https://www.medplum.com/docs/graphql
• Base URL: https://api.medplum.com/fhir/R4/$graphql

Properties

• Documentation
• Example: Patient query
• Naftiko Capability: medplum-graphql.yaml

Medplum Bots

TypeScript serverless functions (AWS Lambda-style) executed in response to FHIR Subscriptions, HTTP triggers, or scheduled cron. Bots are the backbone of Medplum integrations — HL7v2 to FHIR conversion, document generation, webhook fan-out, and questionnaire-driven workflow automation.

• Human URL: https://www.medplum.com/docs/bots

Properties

• Documentation
• JSON Schema (Bot)
• Example: HL7v2 to FHIR Bot
• Naftiko Capability: medplum-bots.yaml

Medplum Subscriptions

FHIR Subscription resources that match search criteria and dispatch real-time notifications via REST hooks (webhooks) or Websockets when matching resources change. Subscriptions are the primary trigger for Bots and external system integrations.

• Human URL: https://www.medplum.com/docs/subscriptions

Properties

• Documentation
• Example: Subscription Webhook

Common Properties

• Website
• Documentation
• Getting Started
• API Reference
• Authentication
• SDK: @medplum/core, @medplum/react, Core SDK docs
• CLI
• Console
• Pricing
• Terms of Service
• Privacy Policy
• Blog
• GitHub Organization
• GitHub Repository
• Discord
• License (Apache 2.0)
• Spectral Rules
• Vocabulary
• JSON-LD Context
• Plans & Pricing
• Rate Limits
• FinOps

Features

• FHIR-Native Datastore — PostgreSQL-backed datastore that natively models FHIR R4 resources, including search, history, and versioning.
• REST + GraphQL APIs — Dual API surface sharing the same authorization, schema, and access policies.
• Bots — AWS Lambda-style TypeScript functions executed by Subscriptions, HTTP, or cron; the integration backbone of Medplum.
• Subscriptions — FHIR Subscription resources dispatch real-time notifications when matching resources change.
• Access Policies — Declarative resource- and field-level authorization rules attached to ProjectMembership.
• SMART on FHIR + OAuth 2.0 — Standards-based authentication; supports SMART App Launch 2.0.0 and Bulk Data 2.0.0.
• TypeScript SDK and React Components — @medplum/core, @medplum/react, @medplum/react-hooks.
• On-Premise Agent — Bridges local clinical systems (HL7v2, DICOM, MLLP) to Medplum cloud.
• AWS CDK Deployment — First-class CDK constructs for self-hosting on AWS.

Use Cases

• Custom EHR development
• Patient engagement portals
• AI scribe and clinical documentation
• HL7v2 to FHIR integration
• Population health and analytics
• Care management workflows
• Revenue cycle automation

Integrations

AWS, HL7v2, FHIRcast, Stripe, Twilio, DocuSeal / DocuSign, SendGrid / Mailgun, AWS HealthLake.

Solutions

Custom EHR, Patient Portal, Provider Portal, AI-Powered Clinical Scribe, Population Health Platform, Revenue Cycle Management.

Maintainers

• Kin Lane — kin@apievangelist.com