We have detected that you are using Internet Explorer to visit this website. Internet Explorer is now being phased out by Microsoft. As a result, NHS Digital no longer supports any version of Internet Explorer for our web-based products, as it involves considerable extra effort and expense, which cannot be justified from public funds. Some features on this site will not work. You should use a modern browser such as Edge, Chrome, Firefox, or Safari. If you have difficulty installing or accessing a different browser, contact your IT support team.
GP Connect Appointment Management - FHIR API
Manage GP practice appointments between different systems.
Page contents
Overview
Use this API to enable administrative and clinical end users to book and manage patient appointments held in any of the principal GP practice systems.
You can:
- retrieve a patient’s appointments
- search for free slots
- read an appointment
- book an appointment
- amend an appointment
- cancel an appointment
For example:
- staff at a GP practice can book, view, amend or cancel appointments on behalf of a patient at another practice
- staff at an urgent care NHS 111 call centre can book, view, amend or cancel appointments on behalf of a patient - at the patient’s registered GP, or federated GP practices
Note: You need to use this API in conjunction with the GP Connect Foundations FHIR API. With this API you can:
-
get patient details - “Read Patient”
-
search for patient - “Patient Search”
-
get practitioner details - “Read Practitioner”
-
search for practitioner - “Practitioner Search”
-
get organisation details - “Read Organisation”
-
search for organisation - “Organisation Search”
-
get location details - “Read Location”
-
register patient - “Register Patient”
For more details, see the GP Connect specifications for developers.
API status
This API (v1.2.7) is in beta.
Technology
This API is a FHIR API.
For more details, see FHIR.
Interactions
For a full list of interactions for this API, see Appointment Management which includes Foundations.
For details on the general structure of the interactions, see FHIR.