Skip to main content

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 retired and not available for use. It has been replaced by the Booking and Referral Standard (BaRS)


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 retired and not available for use.

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 retired and not available for use. It has been replaced by the Booking and Referral Standard (BaRS).


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: 30 April 2025 2:38 pm