Skip to main content
Table of contents

Booking and Referral - FHIR API


This API forms part of the Booking and Referral Standard (BaRS). This API specification should be used in conjunction with the BaRS implementation guide for your use case.

Use this API to send booking and referral information between NHS service providers. You can:

get a specific booking

get bookings for a patient

process a message, either a booking or a referral

get message definition

get capability statement

get a specific referral

get referrals for a patient

get slots

The following describes the end-to-end process:

Send a request from your sender application to this API, along with a service identifier header.

This API redirects the request to the service associated with the service identifier header.

The target backend handles the request and sends a response back to this API.

This API returns the response to your sender application.

In some Applications the target may send a follow up request to indicate the outcome of a request.

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


Booking and Referral - FHIR API documentation