Medicus Developer Documentation
Welcome to the Medicus developer documentation. This is where you can learn about how to build on top of our APIs.
Transactional API
The REST API for clinical integration: create notes, documents, encounters and observations, retrieve care records and documents, and find, match and manage patients and appointments.
Getting Started →Make your first authenticated call in a few minutes.Onboarding & Assurance →How to get approved and go live on the Transactional API.Authentication →How applications sign requests and are granted access.Core (IM1) →Create notes, documents and encounters; find, match and read patients.Front Door →Front-of-house entry points: patient self-service and telephony integrations.Workflow →Actions a clinical system takes after a clinician acts on a result, such as filing investigation reports.Resource Publishing →Distribute and manage clinical content across practices: templates, dashboards and reports.
Bulk Data Extracts (IM1)
Scheduled bulk CSV exports of practice data for analytics and downstream systems, delivered over SFTP or MESH.
Overview →Use cases, data protection, transmission and encryption.Onboarding & Assurance →How to get approved and go live on bulk data extracts.Extract Schema →The tables, columns and delta format.
Patient Facing Services (IM1)
The NHS GP Connect Patient Facing Services API, allowing patients to view their GP record and manage appointments. All onboarding is managed by NHS England.