Care record

Notes, encounters, observations, documents and referrals

📄️Retrieve Care Record

Retrieves the patient's structured care record (allergies, medication, consultations, problems, immunisations, investigations, referrals, diary entries and uncategorised data) via [GP Connect Access Record: Structured](https://digital.nhs.uk/developer/api-catalogue/gp-connect-access-record-structured-fhir). The patient must have an NHS number. Returns a FHIR STU3 Bundle.

📄️List Documents

Lists the documents held against a patient record via [GP Connect Access Document](https://digital.nhs.uk/developer/api-catalogue/gp-connect-access-document-fhir). The patient must have an NHS number. Returns a FHIR STU3 searchset Bundle of DocumentReference resources.

📄️Retrieve Document

Retrieves the binary content of a document by its identifier via [GP Connect Access Document](https://digital.nhs.uk/developer/api-catalogue/gp-connect-access-document-fhir). Returns a FHIR STU3 Binary resource whose `content` field carries the base64-encoded document data.

📄️Create Encounter

Creates a finalised encounter (consultation) against a patient record, with one or more topics, each carrying one or more headings. Coded entries are SNOMED CT `conceptId` + `description` pairs resolved against the NHS term browser. Optionally, observations, notes, and documents can be filed in the same atomic call: see the `observations`/`notes`/`documents` properties on a heading. Every observation, note, and document filed through this endpoint must be nested under a heading; top-level `observations`/`notes`/`documents` arrays are rejected.

📄️Create Note

Creates a clinical note against a patient record. Provide free-text `text`, a SNOMED CT coded entry via `code`, or both; at least one is required.

📄️Create Observation

Records a finalised observation against a patient record. `observationType` (a SNOMED CT coded entry) is required; supply at most one of the `value*` properties to carry the observation result. Coded entries are `conceptId` + `description` pairs resolved against the NHS term browser.

📄️Create Document

Files a document against a patient record. The file content is supplied base64-encoded in `data`. Optionally tag the document with a SNOMED CT `code` and/or `clinicalSpecialty`, both resolved against the NHS term browser.

📄️Create Outbound Referral

Creates an outbound referral against a patient record. Supply a SNOMED CT coded reason via `code` (required). If a `ubrn` is provided the referral is created as an NHS e-RS referral; otherwise a manual referral is created. Optional file `attachments` are base64-encoded.

📄️List Prescriptions

Returns a patient's finalised prescriptions, most recently authorised first, each including its dispense/issue history.