The following profiled FHIR® resources are used in the current version of the Appointment Management capability - see ‘API use cases’ in the menu on the left. Full details of profiled FHIR resources and worked examples are available on the FHIR Reference Server.
Links between GP Connect FHIR resources
The FHIR resources are linked to each other by reference as highlighted in the diagram below:
FHIR resources per GP Connect operation
Search for free slots
Request
Note: No FHIR resource is sent within the request.
Response
- FHIR Bundle
- GPConnect-Slot-1 (based on FHIR Slot)
- GPConnect-Schedule-1 (based on FHIR Schedule)
- CareConnect-GPC-Practitioner-1 (based on FHIR Practitioner)
- CareConnect-GPC-Location-1 (based on FHIR Location)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Book an appointment
Request
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Response
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Retrieve a patient’s appointments
Request
Note: No FHIR resource is sent within the request.
Response
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Read an appointment
Request
Note: No FHIR resource is sent within the request.
Response
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Amend an appointment
Request
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Response
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Cancel an appointment
Request
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Response
- GPConnect-Appointment-1 (based on FHIR Appointment)
- CareConnect-GPC-Organization-1 (based on FHIR Organization)
Errors
If there is a problem with the request or an error occurs during processing of the request then the provider should return an HTTP error along with an “OperationOutcome” resource within the response payload. Details of the required error responses are available on the Error handling guidance page within the specification.