See what our clients say about working with Bonami Software across 200+ projects for 18+ industries. EXPLORE NOW!
We don't just build software. We deliver results. EXPLORE NOW!
See why businesses choose Bonami Software for reliable, scalable solutions. EXPLORE NOW!
We turn ideas into scalable products with proven delivery across 18+ industries. EXPLORE NOW!
See what our clients say about working with Bonami Software across 200+ projects for 18+ industries. EXPLORE NOW!
We don't just build software. We deliver results. EXPLORE NOW!
See why businesses choose Bonami Software for reliable, scalable solutions. EXPLORE NOW!
We turn ideas into scalable products with proven delivery across 18+ industries. EXPLORE NOW!

HL7 vs FHIR Explained.

HL7 and FHIR are not interchangeable, and confusing them causes costly integration failures. Learn what each standard is and when to use it.

BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing
BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing

Talk to Our Integration Team

Building a healthcare integration and need to get the standards right? We'll map the right architecture for your use case — reply within 24 hours.

  • Your idea is 100% protected by our NDA
BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing
BrowserStack
Persistent
Yatra
Kellton
Jade Global
Optum
PokerBaazi
Walmart
Turing

What HL7 Actually Is — and Why It Matters

HL7 (Health Level Seven) is a standards organization producing healthcare interoperability standards since 1987 — not a single standard. Saying you need an "HL7 integration" without naming which HL7 standard is like specifying a database without saying relational, document, or graph.

HL7 vs FHIR — understanding healthcare interoperability standards for digital health integration
🔌

HL7 v2 — The Standard That Refuses to Retire

First published in 1987, HL7 v2 is a pipe-delimited text format that still carries most real-time clinical messages in North American hospitals — ADT events, lab results, pharmacy orders, radiology reports. Every hospital runs an interface engine managing this traffic.

📄

HL7 v3 — Important to Know, Limited in Practice

Developed in the late 1990s as an XML-based replacement for v2, HL7 v3 never reached broad adoption. It remains relevant in Canadian provincial systems and as the basis for C-CDA, the structured clinical document format mandated under U.S. ONC regulations.

FHIR — The Modern Standard

FHIR (Fast Healthcare Interoperability Resources) is the primary standard for new implementations globally, using REST, JSON, and OAuth 2.0. FHIR R4 is the mandated version in the United States under ONC regulations.

📋

C-CDA — For Structured Clinical Documents

The Consolidated Clinical Document Architecture is the mandated format for structured clinical document exchange under U.S. ONC regulations — covering care summaries, discharge summaries, referral notes, and care plans.

🗺️

The Practical Reality for 2026

Digital health teams building for hospitals in 2026 will encounter all three: HL7 v2 for real-time event data, FHIR R4 APIs for certified EHR access, and C-CDA for structured document exchange. Knowing which applies where is the foundation of sound integration architecture.

The Healthcare Interoperability Landscape in 2026

Hover to understand the current state of healthcare standards adoption and what it means for integration architecture decisions.

When to Use Which Standard

A practical decision framework for choosing between HL7 v2, FHIR, and C-CDA based on use case, integration target, and data requirements.

Use HL7 v2 for Real-Time Event-Based Clinical Notifications

ADT events, lab results, radiology reports, pharmacy orders, and scheduling all flow through hospital interface engines as HL7 v2. Where data lives in the v2 layer, connecting there is usually the most reliable approach — whatever FHIR endpoint the EHR also exposes.

Use FHIR for On-Demand Data Queries and EHR Write-Back

FHIR R4 is the right standard for querying patient data on demand, integrating with ONC-mandated EHR APIs, EHR write-back through a standardized interface, and patient-facing data access under information access regulations.

Use C-CDA for Structured Clinical Document Exchange

C-CDA is the ONC-mandated format for care summaries, discharge summaries, referral notes, and care plans. Every certified EHR is required to generate and receive C-CDA for document-level interoperability.

Most Hospital Integrations Require All Three

A digital health product serving hospital customers in 2026 typically needs HL7 v2 for real-time clinical events, FHIR R4 for on-demand queries and write-back, and C-CDA for document interoperability. Designing for only one leaves gaps that surface during live customer implementations.

The Specific Confusions That Break Integrations

Six confusion patterns that appear repeatedly in digital health development — and how each translates directly into expensive integration rework.

Most Expensive

Assuming FHIR Has Replaced HL7 v2

Teams that design entirely on FHIR discover during real hospital work that real-time clinical data is only available through HL7 v2 interfaces. Adding v2 capability after the fact is significant rework, and it usually surfaces during a live integration with a paying customer.

  • ADT Events Are HL7 v2
  • Lab Results Are HL7 v2
  • Interface Engine Is Not a FHIR Server
  • Real-Time ≠ FHIR in Most Hospitals
Versions Matter

Treating FHIR as a Single Standard

FHIR R4 is mandated in the U.S.; FHIR R5 is the latest release. Implementation guides like U.S. Core and Canadian Core add profiles and constraints per context, so implementing FHIR without naming version and guide produces integrations that fail conformance requirements.

  • FHIR R4 vs R5 Difference
  • U.S. Core Profile Requirements
  • Canadian Core Differences
  • Specialty Implementation Guides
False Signals

Conflating Interface Engines with FHIR Servers

Interface engines like Mirth Connect can surface FHIR-flavored layers over HL7 v2 infrastructure, creating the appearance of FHIR capability. That data may be incomplete or non-conformant — validate actual FHIR endpoints through testing, not vendor claims.

  • Validate Actual FHIR Endpoints
  • Test Data Completeness
  • Check Profile Conformance
  • Never Assume from Vendor Claims
Document Exchange

Forgetting C-CDA for Document Workflows

Teams building document exchange on FHIR sometimes overlook that C-CDA is the ONC-mandated format for clinical documents. Certified EHRs must generate and receive C-CDA — not FHIR Documents — for care summary exchange.

  • ONC C-CDA Mandate
  • Discharge Summary Format
  • Referral Note Exchange
  • Transitions of Care Documents
Geography

Applying U.S. FHIR Profiles Internationally

FHIR R4 compliant under U.S. Core does not mean compliant for Canadian or EU deployments. Canadian Core, EU FHIR guides, and other regional profiles reflect local terminology and regulatory requirements that need separate implementation work.

  • Canadian Core vs U.S. Core
  • Provincial Identifier Systems
  • EU FHIR Implementation Guides
  • Regional Terminology Differences
Authorization

Underestimating OAuth and SMART on FHIR Complexity

SMART on FHIR defines how clinical apps launch and authenticate against EHR FHIR endpoints. Patient- and clinician-facing OAuth flows, EHR launch contexts, and scope definitions carry complexities developers from outside healthcare routinely underestimate.

  • SMART on FHIR Launch Context
  • Patient vs Clinician Auth Flows
  • Scope Definition Requirements
  • EHR-Specific OAuth Variants

The Four Standards Every Digital Health Team Needs to Understand

Plain language definitions — what each standard is, where it came from, and where it belongs in your integration architecture.

HL7 v2 — Real-Time Clinical Messaging

FHIR R4 — Modern REST API for Clinical Data

C-CDA — Structured Clinical Documents

HL7 v3 / CDA — Know It, Do Not Build New Things on It

Building a Healthcare Integration and Need to Get the Standards Right?

Whether you are designing a new integration architecture, scoping the HL7 v2 and FHIR R4 capability your product needs for the hospital market, or untangling an integration built on misunderstood foundations, our engineers have shipped across the full HL7 v2, FHIR R4, and C-CDA stack for clinical environments in the U.S. and Canada.

Schedule a Free Consultation
AI Readiness

Award-Winning AI Development & Consulting

2025

100 Fastest Growth Companies

2025

Global Spring Winner

2025

Top App Development Company

2024

AWS Partner Network

2024

Google Cloud Partner

2025

Highly Rated on Trustpilot

2024

Verified Agency

2024

Top App Development Company

2024

ASSOCHAM Member

Frequently Asked Questions

[ 1 ]

If FHIR is so much better than HL7 v2, why has v2 not been replaced?

HL7 v2 has not been replaced because healthcare infrastructure changes far more slowly than technology innovation. The interface engines, HIS configurations, vendor libraries, and processes built around HL7 v2 represent decades of investment, and replacing them means re-implementation, re-testing, and operational disruption that health systems weigh carefully against the benefit. FHIR is growing fast for new integrations, but digital health teams in 2026 need both standards.

[ 2 ]

Is FHIR the same everywhere in the world?

The FHIR base standard from HL7 International is consistent, but national implementation guides create meaningful differences. U.S. Core defines requirements under ONC regulations; Canadian Core reflects provincial identifier systems and data governance; the EU, Australia, and other regions have their own guides. A FHIR integration built for one national context is not automatically compliant with another, even when both use FHIR R4 as the base.

Global presence

Two offices. One team.

Hi, I'm ARIA. Ask me anything about Bonami's AI agents.