Skip to content
FHIRVendors

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.

FundamentalsUpdated 4 min readBy the FHIR Vendors Editorial Team

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

AspectHL7 v2CDA / C-CDAFHIR
Primary patternEvent messages pushed between systemsComplete clinical documentsAPIs over individual resources; also messages, documents, bulk
FormatDelimited text (pipes and carets)XMLJSON, XML, RDF
Typical transportMLLP over TCP inside the networkDirect messaging, HIE query, file exchangeHTTPS
GranularityWhole event (e.g. an admission)Whole documentSingle resource or a query result
Security modelNetwork-level (VPN, firewalls)Depends on transportOAuth 2.0 / SMART on FHIR over TLS
Developer learning curveSteep; site-specific variationSteep; template-heavy XMLModerate; familiar web patterns
Where it dominatesIn-hospital system-to-system feedsCare transitions and HIE documentsPatient and provider apps, payer APIs, new integrations
How the main HL7 standards differ

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

  1. HL7 FHIR Overview
  2. HL7 FHIR R4 specification
  3. HL7 FHIR R4: Comparison with other HL7 standards
  4. 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

Related FHIR services

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.