Frequently asked questions about FHIR service
Important
Azure API for FHIR will be retired on September 30, 2026. Follow the migration strategies to transition to Azure Health Data Services FHIR® service by that date. Due to the retirement of Azure API for FHIR, new deployments won't be allowed beginning April 1, 2025. Azure Health Data Services FHIR service is the evolved version of Azure API for FHIR that enables customers to manage FHIR, DICOM, and MedTech services with integrations into other Azure services.
This section covers some of the frequently asked questions about the Azure Health Data Services FHIR® service.
FHIR service: The basics
What is FHIR?
The Fast Healthcare Interoperability Resources (FHIR) is an interoperability standard intended to enable the exchange of healthcare data between different health systems. This standard was developed by the HL7 organization and is being adopted by healthcare organizations around the world. The most current version of FHIR available is R4 (Release 4). The FHIR service supports R4 and the previous version STU3 (Standard for Trial Use 3). For more information on FHIR, visit HL7.org.
Is the data behind the FHIR APIs stored in Azure?
Yes, the data is stored in managed databases in Azure. The FHIR service in Azure Health Data Services doesn't provide direct access to the underlying data store.
How can I get access to the underlying data?
In the managed service, you can't access the underlying data. This is to ensure that the FHIR service offers the privacy and compliance certifications needed for healthcare data. If you need access to the underlying data, you can use the open-source FHIR server.
What identity provider do you support?
We support Microsoft Entra ID and third party identity provider that support OpenID connect.
Can I use Azure AD B2C with the FHIR service?
Yes. You can use Azure Active Directory B2C (Azure AD B2C) with the FHIR service to grant access to your applications and users. For more information, see Use Azure Active Directory B2C to grant access to the FHIR service.
What FHIR version do you support?
We support versions 4.0.0 and 3.0.1.
For more information, see Supported FHIR features. You can also read about what has changed between FHIR versions (STU3 to R4) in the version history for HL7 FHIR.
What is the difference between Azure API for FHIR and the FHIR service in the Azure Health Data Services?
Azure API for FHIR was our initial generally available product and is being retired as of September 30, 2026. The following table describes differences between Azure API for FHIR and Azure Health Data Services, FHIR service.
| Capabilities | Azure API for FHIR | Azure Health Data Services |
|---|---|---|
| Data ingress | Tools available in OSS | $import operation. For information visit Import operation |
| Autoscaling | Supported on request and incurs charge | Autoscaling enabled by default at no extra charge |
| Search parameters | Bundle type supported: Batch • Include and revinclude, iterate modifier not supported • Sorting supported by first name, last name, birthdate and clinical date |
Bundle type supported: Batch and transaction • Selectable search parameters • Include, revinclude, and iterate modifier is supported • Sorting supported by string and dateTime fields |
| Events | Not Supported | Supported |
| Convert-data | Supports enabling "Allow trusted services" in Account container registry | There's a known issue: Enabling private link with Azure Container Registry may result in access issues when attempting to use the container registry from the FHIR service. |
| Business continuity | Supported: • Cross region DR (disaster recovery) |
Supported: • PITR (point in time recovery) • Availability zone support |
By default each Azure Health Data Services, FHIR instance is limited to storage capacity of 4TB. To provision a FHIR instance with storage capacity beyond 4TB, create a support request with Issue type 'Service and Subscription limit (quotas)'.
What's the difference between the FHIR service in Azure Health Data Services and the open-source FHIR server?
FHIR service in Azure Health Data Services is a hosted and managed version of the open-source Microsoft FHIR Server for Azure. In the managed service, Microsoft provides all maintenance and updates.
When you run the FHIR Server for Azure, you have direct access to the underlying services, but we're responsible for maintaining and updating the server and all required compliance work if you're storing PHI data.
In which regions is the FHIR service available?
FHIR service is available in all regions that Azure Health Data Services is available. You can see supported regions on the Products by Region page.
Where can I see what is releasing into the FHIR service?
The release notes page provides an overview of everything that has shipped to the managed service in the previous month.
To see what will be releasing to the managed service, you can review the releases page of the open-source FHIR Server. We've worked to tag items with Azure Health Data Services if they'll release to the managed service and are available two weeks after they are on the open-source release page in. We have also included instructions on how to test the build, if you'd like to test in your own environment. We're evaluating how to best share additional managed service updates.
To see what release package is currently in the managed service, you can view the capability statement for the FHIR service and under the software.version property. You'll see which package is deployed.
Where can I find what version of FHIR (R4/STU3) is running on my database?
You can find the exact FHIR version exposed in the capability statement under the fhirVersion property (FHIR URL/metadata).
Can I switch my FHIR service from STU3 to R4?
No. We don't have a way to change the version of an existing database. You'll need to create a new FHIR service and reload the data. You can leverage the JSON to FHIR converter as a place to start with converting STU3 data into R4.
Can I customize the URL for my FHIR service?
No. You can't change the URL for the FHIR service.
FHIR Implementations and Specifications
What is SMART on FHIR?
SMART (Substitutable Medical Applications and Reusable Technology) on FHIR is a set of open specifications to integrate partner applications with FHIR Servers and other Health IT systems, such as Electronic Health Records and Health Information Exchanges. By creating a SMART on FHIR application, you can ensure that your application can be accessed and used by many different systems. For more information about SMART, see SMART Health IT.
Does the FHIR service support SMART on FHIR?
Yes, SMART on FHIR capability is supported using AHDS samples. This is referred to as SMART on FHIR(Enhanced). SMART on FHIR(Enhanced) can be considered to meet requirements with SMART on FHIR Implementation Guide (v 1.0.0) and §170.315(g)(10) Standardized API for patient and population services criterion. For more information, visit SMART on FHIR(Enhanced) Documentation.
Can I create a custom FHIR resource?
We don't allow custom FHIR resources. If you need a custom FHIR resource, you can build a custom resource on top of the Basic resource with extensions.
Are extensions supported on the FHIR service?
Yes. We allow you to load any valid FHIR JSON data into the server. If you want to store the structure definition that defines extensions, you can save this as a structure definition resource. To search on extensions, you'll need to define your own search parameters.
How do I see the FHIR service in XML?
In the managed service, we only support JSON. The open-source FHIR server supports JSON and XML. To view the XML version in open-source, use _format= application/fhir+xml.
What is the limit on _count?
The current limit on _count is 1000. If you set _count to more than 1000, you'll receive a warning in the bundle that only 1,000 records will be shown.
Can I post a bundle to the FHIR service?
We currently support posting batch bundles and posting transaction bundles in the FHIR service.
How can I get all resources for a single patient in the FHIR service?
We support the $patient-everything operation which gets you all data related to a single patient.
Does the FHIR service support any terminology operations?
No, the FHIR service doesn't currently support terminology operations.
Using the FHIR service
Can I perform health checks on FHIR service?
To perform a health check on a FHIR service, enter {{fhirurl}}/health/check in the GET request. You should be able to see status of FHIR service. A HTTP Status code response with 200 and OverallStatus as Healthy means your health check is successful.
If there are errors, you may receive an error response with HTTP status code 404 (Not Found) or status code 500 (Internal Server Error), and detailed information in the response body.
Next steps
In this article, you've learned the answers to frequently asked questions about FHIR service. To see the frequently asked questions about FHIR service in Azure API for FHIR, see
Note
FHIR® is a registered trademark of HL7 and is used with the permission of HL7.