Search loading...


Explore and Make use of Nationally Defined Messaging APIs



Guidance for populating and consuming the List profile


The headings below detail the elements of the List profile and describe how to populate and consume them.

List elements


Data type: uri Optionality: Mandatory Cardinality: 1..*

The List profile URL.

Fixed value


Data type: Extension Optionality: Required Cardinality: 0..*

A code or codes warning of an issue related to this list.

This extension is used to capture warnings that the list may be incomplete as data has been excluded due to confidentiality or may be missing due to data being in transit. It MUST be populated using the appropriate code from the table in the warning codes section on the resource population fundamentals page.


Data type: Extension Optionality: Required Cardinality: 0..1

For GP Connect this should be set to ‘1060971000000108 General practice service’.


Data type: Code Optionality: Mandatory Cardinality: 1..1

Whether the list is current, retired or entered-in-error.

current MUST be used for all lists in GP Connect.


Data type: Code Optionality: Mandatory Cardinality: 1..1

Whether the List has a mode of working, snapshot, or changes.

snapshot MUST be used for all lists in GP Connect.


Data type: String Optionality: Mandatory Cardinality: 1..1

Descriptive name for the list. The list titles for primary and secondary lists MUST be the titles as provided in the tables in Using lists to return data.


Data type: CodeableConcept Optionality: Mandatory Cardinality: 1..1

The purpose of the list.

There are currently 9 possible purposes of a list in response to a query for a clinical area in GP Connect that will be represented by the following SNOMED codes.

Purpose SNOMED Code SNOMED Preferred Term / List.title
Medications and medical devices 933361000000108 Medications and medical devices
Allergies and adverse reactions 886921000000105 Allergies and adverse reaction
Ended allergies 1103671000000101 Ended allergies
Immunisations 1102181000000102 Immunisations
List of consultations 1149501000000101 List of consultations
Problems 717711000000103 Problems
Uncategorised data 826501000000100 Miscellaneous record
Outbound Referrals 792931000000107 Outbound referral
Investigations 887191000000108 Investigations and Results
Diary Entries 714311000000108 Patient recall administration

The above code for ‘Ended allergies’ should be used for resolved allergies.


Data type: Reference(Patient) Optionality: Mandatory Cardinality: 1..1

Reference to the patient.


Data type: dateTime Optionality: Optional Cardinality: 0..1

Where the list is used to create primary or secondary lists in response to a query this is when the list was created.

Where a list is used to represent a consultation this is the date the consultation was recorded as specified on the list consultation page


Data type: CodeableConcept Optionality: Optional Cardinality: 0..1

What order the list is in.


Data type: Annotation Optionality: Required Cardinality: 0..1

The text versions of any warning messages included with the list. Where there are multiple warning messages their text is concatenated.


Data type: BackboneElement Optionality: Required Cardinality: 0..*

Entries in the list. Entries are populated in no specific order.

See below for sub elements.

Data type: Boolean Optionality: Optional Cardinality: 0..1

When the item was added to the list.

As GP Connect represents a snapshot at the time the request was made by the consuming system, this is not required to be populated.


Data type: Reference(Any) Optionality: Mandatory Cardinality: 1..1

Actual entry.

Reference to the item that is part of the list.


Data type: CodeableConcept Optionality: Required Cardinality: 0..1

Why the list is empty.

A FHIR code of no-content-recorded MUST be recorded in emptyReason.code if a query returns no results to enter into a list. In this case, List.note MUST be populated with the text ‘Information not available’.

List elements not in use

The following elements MUST NOT be populated:


Data type: Id


Data type: Id


Data type: Instant


Data type: Reference(Practitioner, Patient, Device)

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