Skip to main content
Creating a new NHS England: Health Education England, NHS Digital and NHS England have merged. More about the merger.

NHS Booking - FHIR API

Search for free slots and book an appointment with this API formerly known as FHIR NHS Scheduling API

This API is  in production but deprecated. It will be retired in 12 to 18 months from March 2022.  The Booking and Referral Standard (BaRS) will replace it.  We will contact you before we agree to a retirement date.

This API is still available for existing development, but not for new integrations.  For more details, contact the Booking and referral team.


Overview

Use this API to retrieve available slots and book an appointment for a specific health and care service, for example, from NHS 111 into an Urgent Treatment Centre (UTC).

For a non-technical overview of how to build software that deals with referrals and bookings, see Building healthcare software - referrals and bookings.


Who can use this API

This API can only be used where there is a legal basis to do so. Make sure you have a valid use case before you go too far with your development. You must do this before you can go live.


API status

This API is in production but deprecated,

This API will be retired in 12 to 18 months from March 2022.  

For new integrations, use the Booking and Referral Standard.


Service level

This API is a bronze service, meaning it is operational and supported only during business hours (8am to 6pm), Monday to Friday excluding bank holidays.

For more details, see service levels.


Technology

This API is a FHIR API.

It is based on the HL7 FHIR STU3.

For more details, see FHIR.


Network access

This API is available on the internet.

For more details, see Network access for APIs.


Security and authorisation

You can find out more about security and authorisation here.


Environments and testing

You can find out more about environments and testing here.


Onboarding

This API is in production but deprecated and will be retired in 12 to 18 months from March 2022. 
It is being replaced by the Booking and Referral Standard (BaRS). You need to contact us at [email protected] before you can use this API.


Interactions

All versions are based on the FHIR® STU3 standard.

Status Release Version Release Date Containing Capabilities Version
Live FHIR NHS Booking 2.0.4 June 2021 Search for free slots, book appointment Current version 2.0.4
Beta FHIR NHS Booking 2.0.3 April 2021 Search for free slots, book appointment 2.0.3
Beta FHIR NHS Booking 2.0.2 Beta March 2021 Search for free slots, book appointment 2.0.2
Beta FHIR NHS Booking 2.0.1 Beta November 2020 Search for free slots, book appointment 2.0.1
Beta FHIR NHS Booking 2.0.0 Beta August 2020 Search for free slots, book appointment 2.0.0
Alpha FHIR NHS Scheduling 1.0.6 Alpha April 2020 Search for free slots, book appointment 1.0.6
Alpha FHIR NHS Scheduling 1.0.5 Alpha January 2020 Search for free slots, book appointment 1.0.5
Alpha FHIR NHS Scheduling 1.0.4 Alpha June 2019 Search for free slots, book appointment 1.0.4
Alpha FHIR NHS Scheduling 1.0.3 Alpha December 2018 Search for free slots, book appointment 1.0.3
Alpha FHIR NHS Scheduling 1.0.2 Alpha November 2018 Search for free slots, book appointment 1.0.2

For more details on the specifics of this use case, see Urgent & Emergency Care Appointment Booking

Last edited: 16 December 2022 4:49 pm