NHS Digital FHIR Implementation Guide

This guidance is under active development by NHS Digital and content may be added or updated on a regular basis.



The administration module is covers core base data used within NHS (England) interoperability and data standards. The data model standards are document in the NHS Data Dictionary

NHS Digital provides a wide area of API and registries to support administration across the NHS (England)

These standards are supported in all NHS (England) versions of HL7 and these mirror real NHS concepts.  

Patient Registers

Track people involved in receiving healthcare, the basics nearly everything else references back to

Name NHS (England) or UK Profile API or Registry Description
Patient NHSDigital-Patient Personal Demographics Service - FHIR API Demographics and other administrative information about an individual or animal receiving care or other health-related services.
RelatedPerson UK Core RelatedPerson See Personal Demographics Service - FHIR API Information about a person that is involved in the care for a patient, but who is not the target of healthcare, nor has a formal responsibility in the care process.
Person Demographics and administrative information about a person independent of a specific health-related context.
Group Represents a defined collection of entities that may be discussed or acted upon collectively but which are not expected to act collectively, and are not formally or legally recognized; i.e. a collection of entities that isn't an Organization.

Type Description
Patient Notification Events For PAS or MPI events see ADT_A28, ADT_A31 and ADT_A40 in HSCIC ITK HL7 V2 Message Specifications

For PDS see Personal Demographics Service Notifications - FHIR

Service Provider Directory Resources

Service Provider Directory resources are usually stored in the administration section of applications, and may even be synchronized from external systems.

Name NHS (England) or UK Profile API or Registry Description
Organization NHSDigital-Organization Organisation Data Service - FHIR API

Organisation Data Service - ORD API

Organisation Data Service
A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, payer/insurer, etc.
Location Details and position information for a physical place where services are provided and resources and participants may be stored, found, contained, or accommodated.
Practitioner NHSDigital-Practitioner Organisation Data Service A person who is directly or indirectly involved in the provisioning of healthcare.
PractitionerRole NHSDigital-PractitionerRole Spine Directory Service - LDAP API A specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.
HealthcareService NHSDigital-HealthcareService Directory of Services - Urgent and Emergency Care - REST API

Electronic Prescription Service Directory of Services API
The details of a healthcare service available at a location.
Endpoint SDS-Endpoint Spine Directory Service - LDAP API

Spine Directory Service - FHIR API
The technical details of an endpoint that can be used for electronic services, such as for web services providing XDS.b or a REST endpoint for another FHIR server. This may include any security context information.

Scheduling and Appointments 

The Scheduling/Appointment resources permit the planning of encounters to occur and follow on with other clinical activities.

Name NHS (England) or UK Profile API or Registry Description
Schedule UK Core Schedule Booking and Referral - FHIR API A container for slots of time that may be available for booking appointments.
Slot UK Core Slot Booking and Referral - FHIR API A slot of time on a schedule that may be available for booking appointments.
Appointment UK Core Appointment Booking and Referral - FHIR API A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s).
AppointmentResponse Booking and Referral - FHIR API A reply to an appointment request for a patient and/or practitioner(s), such as a confirmation or rejection.

Type Description
Appointment Notification Events For PAS events see ADT_A05 in HSCIC ITK HL7 V2 Message Specifications

Clinical Categorisation Resources 

Most clinical activities occur grouped in some way. Long term care is typically covered by an EpisodeOfCare, whereas short term care is covered by encounters. Account associates the tracking of transactions back to a Patient (or other resource). Flag is just used to highlight a warning or other notification about a patient (or other resource)

Name NHS (England) or UK Profile Alias Description
EpisodeOfCare UK Core EpisodeOfCare Case Program Problem An association between a patient and an organisation / healthcare provider(s) during which time encounters may occur. The managing organisation assumes a level of responsibility for the patient during this time.
Encounter UK Core Encounter Visit An interaction between a patient and healthcare provider(s) for the purpose of providing healthcare service(s) or assessing the health status of a patient.
Account Cost centre A financial tool for tracking value accrued for a particular purpose. In the healthcare field, used to track charges for a patient, cost centers, etc.
Flag UK Core Flag Barriers to Care, Alert Prospective warnings of potential issues when providing care to the patient.

Type Description
Encounter Notification Events For PAS events see ADT_A01, ADT_A02, ADT_A03, ADT_A04, etc in HSCIC ITK HL7 V2 Message Specifications
back to top