Skip to main content

Development guidance

General development guidance for GP Connect services, including clinical safety, onboarding, error handling, and information governance.

Introduction

Use the sections below to explore guidance for developing integrations with GP Connect APIs.


Cross-API information

Clinical safety and governance

Explore how GP Connect represents clinical data using the FHIR STU3 standard.

Implementation essentials

These essential topics guide you through implementing, securing, and integrating GP Connect services across NHS systems.

  • FHIR library
    Overview of reusable FHIR components used across GP Connect APIs.
  • FHIR implementation
    Guidance on implementing FHIR standards within GP Connect services.
  • General API guidance
    Best practices and standards for developing GP Connect APIs.
  • Branch surgeries
    Information on handling branch surgery configurations in GP Connect.
  • Security
    Security principles and requirements for GP Connect API development.
  • Error handling
    Guidance on how to handle errors in GP Connect API requests.
  • Volumetric and performance
    Details of the GP Connect API volume and performance characteristics.
  • Non-functional requirements
    Details of system attributes such as security, reliability, maintainability, scalability, and usability.
Integration and infrastructure

These topics show you how to connect your system to NHS infrastructure and manage secure, reliable data exchange across GP Connect services:


API-specific information

GP Connect API 1.6.2 - Access Record: Structured, Access Document, Foundations

Access Record: Structured

Access Document

  • GP Connect: Access Document - Implementation Guide
    Guidance on how to retrieve clinical documents from GP systems. This guide supports developers and clinical safety teams with implementation details, resource mappings, and guidance for handling document types and metadata.

  • GP Connect: Access Document - FHIR API 
    This page in the API and integration catalogue includes technical specifications, prerequisites, and onboarding guidance for the Access Document capability, which enables the retrieval of clinical documents - such as letters and reports - from GP systems.

Foundations

  • GP Connect: Foundations - FHIR
    Shows you the essential FHIR building blocks and Spine connectivity requirements you need before developing integration with any GP Connect capability.
GP Connect API 0.7.4 - Access Record: HTML, Foundations

Access Record: HTML

Foundations

  • GP Connect Foundations - FHIR
    Shows you the essential FHIR building blocks and Spine connectivity requirements you need before developing integration with any GP Connect capability.

Further information

Specifications and API references

Explore additional resources to support your development and integration with GP Connect capabilities.

Community and support

Last edited: 14 November 2025 12:12 pm