GP Connect demonstrator

GP Connect API is an FHIR® based API for communicating with GP IT systems. For more information on GP Connect API please see the GP Connect specifications page.

This site contains tools to explore and develop GP Connect API consumer applications.

Consumer system demonstrator

The consumer system demonstrator illustrates how the GP Connect API might be integrated with an electronic patient record (EPR) or Trust portal system.

View the consumer system demo
for Access Record HTML
View the consumer system demo
for Appointment Management


Consumer system demonstrator screenshot
Consumer system demonstrator screenshot

Developer tools

API reference implementation

This is a reference implementation of the GP Connect API simulating a GP system's GP Connect interface.

To interoperate with the reference implementation using your own development/test environment, use the following FHIR service root URLs:

GP Connect API 0.7 (DSTU2) Access Record HTML https://orange.testlab.nhs.uk/gpconnect-demonstrator/v0_7/fhir
GP Connect API 1.2 (STU3) Appointment Management/ Foundations https://orange.testlab.nhs.uk/gpconnect-demonstrator/v1/fhir
Access Record Structured (v1.2) https://orange.testlab.nhs.uk/gpconnect-demonstrator/v1/fhir
GP Connect API 1.5 (STU3) Access Record Structured (v1.5) https://orange.testlab.nhs.uk/B82617/ STU3/1/gpconnect/structured/fhir
Access Document https://orange.testlab.nhs.uk/B82617/ STU3/1/gpconnect/documents/fhir

Alternatively you may look the above URLs up on our Spine Directory Service.


Interactive API documentation

Interactive API documentation, built using Swagger UI, is available for developers to test calls against the API reference implementation using their web browser.

Try the interactive API document'n
for Access Record HTML
Try the interactive API document'n
for Appointment Management
Try the interactive API document'n
for Access Rec. Structured (v1.2)
Try the interactive API document'n
for Access Rec. Structured (v1.5)
Try the interactive API document'n
for Access Document


Postman samples

Run Postman samples to test calls against the API reference implementation.


Test data

Test patients and other data held within the demonstrator is listed here.


Spine Directory Service

An SDS server containing the MHS and AS records needed to discover the provider reference implementation endpoints by ODS code.

Please see the documentation links below (either LDAP or FHIR) for instructions on the SDS queries to run in order to discover the provider reference implementation endpoints.

SDS (LDAP secure) ldaps://orange.testlab.nhs.uk See LDAP documentation
SDS (FHIR base URL) https://orange.testlab.nhs.uk/spine-directory/FHIR/R4/ See FHIR documentation (TBC)

*Please note: this SDS server contains records in order to discover the GP Connect provider reference implementation ONLY, and does not contain other records as would be found in Spine test or production environments.


Opentest documentation

Documentation for the Opentest environment can be found here.