HL7 vs FHIR: What's the Difference?
"HL7 or FHIR?" is a confusing question because FHIR is an HL7 standard. This guide separates the organization from its family of standards and explains where each fits.
Key takeaways
- HL7 International is a standards development organization; HL7 v2, HL7 v3, CDA and FHIR are standards it publishes.
- When people say "HL7" in an integration context, they usually mean HL7 v2 messaging, not the organization or FHIR.
- CDA and its US implementation C-CDA remain central to document exchange, while FHIR is the standard for modern APIs.
- Most healthcare organizations run several HL7 standards at once, so the practical question is which standard fits each data flow.
Why "HL7 vs FHIR" is a confusing question
Asking "HL7 or FHIR?" is a little like asking "Microsoft or Excel?". HL7 International is the organization. FHIR is one of the standards it publishes. The confusion comes from everyday shorthand: integration teams have said "HL7" for decades to mean HL7 version 2 messages flowing through an interface engine, so the name of the organization became the name of a message format.
Getting the vocabulary right matters when you write requirements or talk to vendors. "We need HL7 integration" might mean an ADT feed over MLLP, a C-CDA document exchange or a FHIR API, and those are very different projects with different costs. This guide untangles the terms; if you are new to FHIR itself, start with What is FHIR?.
HL7 International: the organization
Health Level Seven International is a not-for-profit, ANSI-accredited standards development organization founded in 1987. The "Level Seven" refers to the application layer, the seventh layer of the OSI networking model, which is where HL7's standards operate.
HL7 standards are written by volunteer work groups (Patient Administration, Orders and Observations, Pharmacy, Financial Management and many more) and approved through balloting. Members include providers, EHR and software vendors, payers, government agencies and individual experts. HL7 also runs accelerator programs that develop implementation guides for specific communities, such as payer-provider exchange.
This site is independent. We are not affiliated with or endorsed by HL7 International; we reference its published specifications as primary sources.
The HL7 family of standards
HL7 publishes many standards, but four matter most for integration planning.
HL7 Version 2 (v2.x)
HL7 v2 is an event-driven messaging standard first released in the late 1980s. Messages are plain text, made of segments (MSH, PID, PV1, OBX) with fields separated by pipe characters. It covers admissions and transfers (ADT), orders (ORM/OML), results (ORU), scheduling (SIU) and financial transactions (DFT). Versions such as 2.3, 2.4 and 2.5.1 remain widely deployed. Its flexibility made it universal inside hospitals, and it also means every interface needs site-specific mapping.
HL7 Version 3 and the RIM
HL7 v3 was an attempt to fix v2's ambiguity with a formal, model-driven approach built on the Reference Information Model (RIM) and XML messaging. It was rigorous but complex, and v3 messaging saw limited adoption outside specific national programs. Its lasting legacy is the RIM-based thinking that shaped CDA and influenced FHIR's design.
CDA and C-CDA
The Clinical Document Architecture (CDA) is an XML standard for persistent, human-readable and machine-processable clinical documents. In the US, Consolidated CDA (C-CDA) templates such as the Continuity of Care Document became the backbone of document exchange under federal EHR certification programs and health information exchanges. Discharge summaries, referral notes and care summaries still commonly travel as C-CDA.
FHIR
FHIR is HL7's newest major standard, first published as a draft in 2014. It combines lessons from v2 (pragmatism), v3 (rigorous modeling) and CDA (documents) with modern web practice: RESTful APIs, JSON, OAuth 2.0-based security through SMART, and a strong emphasis on implementability. It can carry messages and documents too, but its API model is what sets it apart.
Side-by-side comparison
| Aspect | HL7 v2 | CDA / C-CDA | FHIR |
|---|---|---|---|
| Primary pattern | Event messages pushed between systems | Complete clinical documents | APIs over individual resources; also messages, documents, bulk |
| Format | Delimited text (pipes and carets) | XML | JSON, XML, RDF |
| Typical transport | MLLP over TCP inside the network | Direct messaging, HIE query, file exchange | HTTPS |
| Granularity | Whole event (e.g. an admission) | Whole document | Single resource or a query result |
| Security model | Network-level (VPN, firewalls) | Depends on transport | OAuth 2.0 / SMART on FHIR over TLS |
| Developer learning curve | Steep; site-specific variation | Steep; template-heavy XML | Moderate; familiar web patterns |
| Where it dominates | In-hospital system-to-system feeds | Care transitions and HIE documents | Patient and provider apps, payer APIs, new integrations |
For a deeper technical comparison of message structure, transport and mapping, read FHIR vs HL7 v2.
Why FHIR gained momentum
FHIR did not win because older standards stopped working. It won the API space because healthcare needed things v2 and CDA were never designed to do: let a third-party app on a phone query a patient's medications, let a payer pull clinical data for a member on demand, or let a clinical decision support tool launch inside the EHR with the right context.
- Web-native design means general software engineers can be productive without years of HL7 v2 experience.
- Granular access lets clients request exactly the data they need instead of parsing whole documents or subscribing to every event.
- Standard security through SMART App Launch makes third-party app access governable.
- Regulatory backing in the US, through ONC certification requirements and CMS interoperability rules, created a large installed base of FHIR APIs.
Choosing between HL7 standards in practice
Most organizations do not choose one standard; they choose the right one per data flow. A reasonable default for new work:
- Use HL7 v2 for high-volume, real-time internal feeds where the EHR and departmental systems already speak it, such as ADT to a lab or results back from a lab system.
- Use C-CDA where a network or partner requires document exchange, such as many HIE and transitions-of-care workflows.
- Use FHIR for apps, external partners, analytics extracts via Bulk Data, payer requirements and any new integration where the counterpart offers a FHIR API.
- Bridge with an interface engine or integration platform that can translate v2 or CDA into FHIR when downstream consumers need a single model.
If you need help sorting existing interfaces into this picture, HL7 FHIR consulting firms typically start with an interface inventory, and the healthcare data interoperability service page explains what that work covers.
Frequently asked questions
Is FHIR part of HL7?
Yes. FHIR is a standard published and maintained by HL7 International, the same organization that publishes HL7 v2, HL7 v3 and CDA.
When a job posting asks for "HL7 experience", does that include FHIR?
Usually it means HL7 v2 interface experience, often with an interface engine. Postings that need FHIR skills generally say FHIR explicitly. Ask if it is unclear.
Is HL7 v3 still used?
HL7 v3 messaging has limited use today. CDA, which grew out of the v3 modeling work, is still widely used for clinical documents.
Can FHIR carry the same data as an HL7 v2 message?
Largely yes. HL7 has published guidance for mapping v2 messages to FHIR resources, though local v2 customizations (Z-segments and site-specific field use) always need case-by-case mapping.
Will FHIR replace C-CDA?
FHIR has its own document model, and work is under way to align C-CDA content with FHIR. For now, both coexist, and many networks still require C-CDA for document exchange.
References
- HL7 FHIR Overview
- HL7 FHIR R4 specification
- HL7 FHIR R4: Comparison with other HL7 standards
- ONC HealthIT.gov
FHIR® is a registered trademark of HL7 International. This guide is independent educational content and is not legal or compliance advice.
Related guides
- What Is FHIR? How the HL7 FHIR Standard WorksFHIR is the HL7 standard for exchanging healthcare data through web APIs. This guide explains resources, the REST API, profiles, extensions and versions in plain terms.
- FHIR vs HL7 v2: A Technical Comparison for Integration TeamsA side-by-side technical look at HL7 v2 messaging and FHIR: data structure, transport, eventing, mapping an ADT^A01 to FHIR, and how the two coexist in real architectures.
- How FHIR Enables Healthcare InteroperabilityFHIR is a powerful interoperability tool, but only one layer of it. This guide maps FHIR to the four levels of interoperability, the terminologies it depends on, and the policy frameworks driving adoption.
Related FHIR services
- HL7 FHIR ConsultingWhat HL7 FHIR consultants deliver, from interoperability strategy and regulatory readiness to architecture reviews and IG authoring, and how to pick a firm.
- Data InteroperabilityData interoperability services for multi-party exchange: HIEs, payer-provider APIs, TEFCA, terminology, identity matching, consent and vendor questions.
- FHIR MigrationFHIR migration services: moving from HL7 v2, CDA or proprietary APIs to FHIR, upgrading DSTU2/STU3 to R4, or switching FHIR servers without breaking consumers.
Find the Right FHIR Integration Partner for Your Healthcare Project
Tell us what you need to build or connect. We review every request and share a short list of relevant vendors from our directory — no obligation.