FHIR R4 Integration Guide UK — NHS APIs, HL7 FHIR & UK Core Profiles (2025)

🏥 HL7 FHIR R4🔌 NHS Spine📋 UK Core Profiles🔒 UK GDPR💊 GP Connect🔑 NHS Login
June 202513 min readClickMasters NHS Integration Team

Direct Answer

FHIR (Fast Healthcare Interoperability Resources) R4 is the international standard for exchanging healthcare information electronically. NHS England requires FHIR R4 with UK Core profiles for all new NHS digital services. UK Core adds NHS-specific constraints and extensions to the base FHIR R4 standard — making UK healthcare interoperability more consistent. ClickMasters has implemented NHS Spine, GP Connect, NHS Login, and custom FHIR R4 servers for UK HealthTech clients.

Key NHS APIs Using FHIR R4

NHS APIPurposeFHIR ResourcesAuth Method
NHS Spine (PDS)Patient Demographics Service — verify NHS numbers, patient detailsPatient resource (UK Core)NHS smartcard / API key + OAuth2
GP Connect (Record Access)Access GP clinical records for connected NHS servicesPatient, Condition, Medication, ObservationNHS system OAuth2 + smartcard
GP Connect (Appointments)Book/manage GP appointments digitallySlot, Appointment, ScheduleNHS system OAuth2
NHS LoginPatient identity verification — P5 (low) and P9 (high) assurance levelsOIDC/OAuth2 — not FHIRNHS Digital OIDC client credentials
NHS 111 / UEC APIsUrgent care referral and transferEncounter, ServiceRequestNHS API management platform
Electronic Prescription Service (EPS)Digital prescription creation and dispensingMedicationRequest, MedicationDispenseNHS smartcard

UK Core FHIR Profiles — Why They Matter

UK Core adds NHS-specific identifier systems (NHS Number, ODS codes, SNOMED CT UK edition)

UK Core constrains cardinality on clinical resources to match NHS data quality standards

UK Core adds UK-specific extensions for GP systems, consent models, and clinical coding

UK Core profiles are versioned — implementation must specify the version it supports

NHS Digital publish UK Core conformance resources (StructureDefinitions, ValueSets, CodeSystems) on the NHS Digital FHIR server

UK Core is the NHS England-mandated set of profiles and extensions that constrain and extend base FHIR R4 for UK use. Implementing generic FHIR R4 is not sufficient for NHS integration — you must implement UK Core profiles. Key differences:

NHS Login Integration — Patient Identity Verification

Assurance LevelWhat's VerifiedUse CaseVerification Method
P5 — MediumEmail + basic demographic matchNon-clinical, lower-risk servicesOnline ID document scan + demographic match
P9 — HighFull identity verificationClinical services, prescription accessIn-person ID verification or video ID proofing

NHS Login integration requires: supplier agreement with NHS Digital, test environment onboarding (sandbox → integration → production pathway), implementation of OIDC authorisation code flow with PKCE, and privacy notice meeting NHS Login requirements.

Frequently Asked Questions — FHIR R4 Integration UK

Related Guides & Services

Frequently Asked Questions

Common questions about fhir r4 integration guide uk — nhs apis, hl7 fhir & uk core profiles (2025).

HL7 FHIR has had multiple versions. DSTU2 and STU3 are older versions still in use on legacy NHS systems. R4 is the current stable release and is mandated by NHS England for new systems. Many NHS organisations are mid-migration from STU3 to R4. If you're building a new NHS-connected application, implement R4 with UK Core profiles. If you're integrating with an existing NHS system, check which FHIR version that system exposes.

Not necessarily. If you're consuming NHS FHIR APIs (reading patient data from NHS Spine or GP Connect), you need a FHIR client implementation — not a full server. If you're exposing your own data to NHS systems (e.g., sending clinical data to NHS Spine), you need a FHIR server that can receive and validate FHIR resources. ClickMasters has implemented both FHIR clients and servers for UK HealthTech projects.

A basic NHS Login integration (P5 identity only): 3–6 weeks. GP Connect record access integration: 8–16 weeks (including NHS Digital onboarding and environment testing). NHS Spine PDS integration: 6–12 weeks. Full FHIR R4 server implementation: 8–20 weeks depending on the resources required. The NHS Digital onboarding process (supplier agreement, environment access, conformance testing) typically takes 4–8 weeks and runs in parallel with development.

About the Author

ClickMasters NHS Integration Team FHIR R4, NHS Login, and GP Connect integration specialists ClickMasters has delivered NHS-connected digital health applications including NHS Login integration, GP Connect Record Access, and custom FHIR R4 servers. All implementations use UK Core profiles and are DTAC-aware.

Build Your NHS FHIR Integration ClickMasters...

Build Your NHS FHIR Integration ClickMasters has implemented NHS Login, GP Connect, and FHIR R4 servers for UK HealthTech clients. Free consultation to scope your integration. → Book Free NHS Integration Consultation: clickmasterssoftwaredevelopmentcompany.co.uk/contact/

Book a Free Consultation