Search loading...


Explore and Make use of Nationally Defined Messaging APIs


Open API design principles

High-level design principles related to the Open API design.
  • FHIR API providers to provide a Conformance resource for the server
  • FHIR RESTful API principles to be used by default
    • synchronous endpoints using GET, POST, PUT and DELETE HTTP verbs
  • FHIR Operation APIs to be used in limited “set piece” circumstances
    • for example, to pull bundles of resources without using the full generic querying syntax
  • Uniform Resource Identification (URI) as the resource’s Logical Identity
  • business identifiers (such as NHS Number) used to resolve a resource’s Logical Identity
  • resources represented as either XML or JSON as requested by the API consumer. To ensure maximum accessibility, GP Connect is expecting producers to support both formats. However since XML is on average 30% larger on the wire there is a preference towards use of JSON.
  • HTML content to utilise XHTML in line with the FHIR Narrative guidance
  • eTags for managing version aware updates

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