Addiction recovery programs sit on top of a FHIR workload that is both privacy-sensitive and operationally dense. Substance Use Disorder records carry 42 CFR Part 2 segmentation requirements, MedicationStatement histories for buprenorphine and naltrexone need careful authorization handling, and the structured assessments used to drive clinical decisions arrive on a weekly cadence. Picking a FHIR server here means weighing consent and segmentation features as heavily as raw performance.
For more background on the relevant servers, see the FHIR architecture archive and the parent preventive care FHIR servers buyer's guide.
The 5 Servers Worth Knowing
- HAPI FHIR with Smile Digital Health packaging. The default pick. Smile has documented patterns for 42 CFR Part 2 consent segmentation using Consent resources and labeled access policies, which most other servers handle less cleanly.
- Aidbox. The fit when the recovery program wants SQL-on-FHIR for outcomes reporting against retention, medication adherence, and overdose-event cohorts. The access control model supports fine-grained Consent-driven policies.
- Microsoft Azure Health Data Services. The managed pick for Azure-aligned recovery networks. Identity integration with Entra ID supports counselor-and-clinician role separation, and the FHIR service has matured on consent handling over the last two releases.
- Medplum. The lighter option for early-stage recovery telehealth startups. Developer ergonomics speed initial build, though 42 CFR Part 2 segmentation needs custom work to be production-ready.
- Google Cloud Healthcare API. The right call for groups that want BigQuery analytics on retention and outcomes data. The consent and access policy layer needs careful configuration before handling Part 2 records.
What Matters for the Recovery Workload
Substance use disorder programs put unusual weight on a few FHIR features:
- Consent resources have to drive access at the API layer, not as a downstream filter applied during reporting
- MedicationStatement and MedicationRequest need clean separation of buprenorphine, methadone, and naltrexone entries with X-DEA and authorization metadata
- Observation and Questionnaire capture weekly self-report assessments, including PHQ-9, GAD-7, and craving scales
- Encounter has to model both in-person and telehealth visits with separate billing implications
A few operational requirements worth probing during pilot:
- The server should enforce Consent at the resource read level, not via a downstream reporting filter.
- Audit logging should capture both successful and denied reads against segmented records.
- `$export` should respect Consent labels so bulk analytics pipelines do not leak segmented data into shared dashboards.
Servers that handle Consent loosely tend to push the segmentation logic into application code, which is fragile under audit.
How the Decision Usually Goes
Single-program recovery clinics often pick HAPI plus Smile for the documented Part 2 patterns, or Medplum if the team is comfortable building the segmentation layer themselves. Multi-state recovery networks tend to land on Aidbox for the consent-driven access policies and outcomes analytics. Enterprise recovery programs embedded in larger behavioral health systems often inherit Microsoft Azure Health Data Services from the parent organization.
For an adjacent practice pattern with similar Observation density and structured assessment cadence, the Best FHIR Servers for Physical Therapy EHR Backends writeup is the closest parallel.
Sources
- FHIR Consent resource specification - HTML, HL7, 2026
- Understanding and Implementing the Updates to 42 CFR Part 2 - PDF, Network for Public Health Law, 2025
- US Core Implementation Guide STU 6.1.0 - HTML, HL7, 2024








