Firely.Fhir.Validation.R4 3.6.0

Prefix Reserved
dotnet add package Firely.Fhir.Validation.R4 --version 3.6.0
                    
NuGet\Install-Package Firely.Fhir.Validation.R4 -Version 3.6.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Firely.Fhir.Validation.R4" Version="3.6.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Firely.Fhir.Validation.R4" Version="3.6.0" />
                    
Directory.Packages.props
<PackageReference Include="Firely.Fhir.Validation.R4" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Firely.Fhir.Validation.R4 --version 3.6.0
                    
#r "nuget: Firely.Fhir.Validation.R4, 3.6.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Firely.Fhir.Validation.R4@3.6.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Firely.Fhir.Validation.R4&version=3.6.0
                    
Install as a Cake Addin
#tool nuget:?package=Firely.Fhir.Validation.R4&version=3.6.0
                    
Install as a Cake Tool

Introduction

This is Firely's official FHIR validator API for validating HL7 FHIR resources against profiles. These profiles contain the full gamut of FHIR validation rules, and are used to validate the data in the FHIR resources.

Release notes

Read the releases notes on firely-net-sdk/releases.

Documentation

You can find documentation on the validation api at the Firely docs site.

Getting Started

Before installing one of the NuGet packages (or clone the repo) it is important to understand that HL7 has published several updates of the FHIR specification, each with breaking changes - so you need to ensure you use the version that is right for you. Read the online documentation, and download the correct package for your FHIR release by searching for Firely.Fhir.Validation.<spec version>. For most developers, just including this NuGet package is enough to get started.

The main class in this package is the Validator.

⚠️ Thread-safety warning: The Validator class and its associated resolvers (including their internal caches) are not thread-safe. If you need to perform validation concurrently across multiple threads, you must create a separate Validator instance (and separate resolver instances) for each thread. Sharing a single instance across threads without synchronization will result in unpredictable behavior.

An example implementation can be found here.

Using a pre-release NuGet package

Every release of the validator API results in a NuGet package on the normal NuGet feed. However, each commit on our develop branch also results in a pre-release package. These are public too. So if you want to be brave and use a pre-release packages, you can do so by adding https://nuget.pkg.github.com/FirelyTeam/index.json to your NuGet sources:

  • Get a Personal Access token (PAT) from github.com with scope read:packages

  • Next open a console on your machine and run dotnet nuget add source --name github --username <USERNAME> --password <PAT> https://nuget.pkg.github.com/FirelyTeam/index.json

USERNAME: your username on GitHub PAT: your Personal access token with at least the scope read:packages

Support

We actively monitor the issues coming in through the GitHub repository. You are welcome to register your bugs and feature suggestions there. For questions and broader discussions, we use the .NET FHIR Implementers chat on Zulip.

Contributing

We are welcoming contributions!

If you want to participate in this project, we're using Git Flow for our branch management. Please submit PRs on GitHub with changes against the develop branch.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Firely.Fhir.Validation.R4:

Package Downloads
brianpos.Fhir.R4.DemoFileSystemFhirServer

Demonstration implementation of a FHIR R4 Facade using the file system as a super simple storage provider

InteropSuite

Healthcare data interoperability platform. Transforms HL7 v2.x (30 types), C-CDA R2.1 (9 documents), and X12 5010 (13 transactions) into validated FHIR R4 bundles with US Core 6.1.0 and CMS 0057-F profile compliance. Includes preflight validation, HIPAA-compliant quarantine, and audit logging.

HealthData.Interop.Fhir

Meta-package for the HealthData.Interop FHIR R4 toolkit. Bundles FHIR client services, US Core validation, SMART on FHIR auth, CSV-to-FHIR ETL, HIPAA-aware security examples (RBAC, PHI masking, audit), and drift detection. Depends on HealthData.Interop.Abstractions, HealthData.Interop.Logging.Extensions, and HealthData.Interop.Logging.Serilog. Provided as-is; does not by itself ensure HIPAA compliance.

LevelUp.Health.Migration

FHIR data-migration accelerator for the LevelUp.Health backend: idempotent $import/$export load transport, business-identity idempotency, medallion staging, US-Core profile validation, terminology resolution, and a retrieve-then-$validate AI mapping harness — all behind neutral ports with in-repo reference implementations. Live Azure/terminology/LLM backends are opt-in seams.

Medical.Fhir

Medical.Net FHIR R4 on the Firely .NET SDK: domain ↔ FHIR mapping (Patient, Encounter, Observation, Condition, MedicationRequest, AllergyIntolerance), transaction and International Patient Summary bundles, JSON round-trip, validation, FHIRPath, a versioned FHIR repository (search, _include/_revinclude, _history, transactions), profile validation (Firely validator, IG packages), SMART on FHIR client and an Indonesian SATUSEHAT workflow client with KFA and retry/backoff.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.6.0 4,059 10/29/2026
3.5.0 10,186 10/13/2026
3.4.0 11,071 10/1/2026
3.3.1 34,517 8/6/2026
3.3.0 9,900 7/8/2026
3.2.0 21,849 5/11/2026
3.1.1 20,220 3/24/2026
3.1.0 61,532 1/13/2026
3.0.1 13,529 10/28/2025
3.0.0 25,632 10/15/2025
2.7.3 9,070 3/26/2026
2.7.1 10,417 10/28/2025
2.7.0 7,195 8/27/2025
2.6.9 17,788 7/17/2025
2.6.8 552 7/15/2025
2.6.7 2,935 6/13/2025
2.6.6 1,796 5/22/2025
2.6.5 27,118 4/3/2025
2.6.4 1,146 4/3/2025
2.6.3 22,970 3/4/2025
Loading failed