Search loading...

API Hub

Explore and Make use of Nationally Defined Messaging APIs

 

Interaction IDs

A list of GP Connect API interaction IDs

GP Connect Interaction ID naming policy

All interaction IDs are expected to follow the following format urn:nhs:names:services:[programme]:[capability]:[standard]:[mechanism]:[operation]:[subject]

  • Programme = gpconnect
  • Capability = [ documents ]
  • Standard = fhir
  • Mechanism = [ rest, operation ]
    • rest for RESTful API interactions
    • operation for custom Operation API interactions
  • Operation
    • RESTful style = [ create, read, update, delete, search ] + any more specific actions (for example, cancel)
    • Extended operation = [ gpc.getcarerecord, gpc.registerpatient ]
  • Subject = [ resourceType, operationName ]
    • Resource Type is the name of a FHIR resource, such as Patient, Appointment, Organization
    • Operation Name is the name of a extended operation, such as gpc.getcarerecord

List of Interaction IDs

Operation InteractionID
Read metadata urn:nhs:names:services:gpconnect:documents:fhir:rest:read:metadata-1
Patient search urn:nhs:names:services:gpconnect:documents:fhir:rest:search:patient-1
Search for documents urn:nhs:names:services:gpconnect:documents:fhir:rest:search:documentreference-1
Retrieve documents urn:nhs:names:services:gpconnect:documents:fhir:rest:read:binary-1

All content is available under the Open Government Licence v3.0, except where otherwise stated