Implementation guide for interoperable medicines

This guidance is under active development by NHS England and content may be added or updated on a regular basis.

Example #1: Bundle - Medication on Admission

Note: Example validated against UKCore, dm+d and SNOMED-CT on 23 May 2025.
<Bundle xmlns="http://hl7.org/fhir">
<id value="7cd3f180-76f7-4bc6-b6d5-e672acd83b81" />
<system value="urn:[organisation_name]:[system_name]" />
<value value="urn:8cd8108d-8c72-4fe9-a284-cd28b127fcfa" />
</identifier>
<type value="message" />
<timestamp value="2021-05-13T13:47:12+00:00" />
<fullUrl value="urn:message-header-2123123" />
<MessageHeader>
<id value="message-header-2123123" />
<system value="http://hl7.org/fhir/message-events" />
<code value="current-medication" />
<display value="Current Medication" />
</eventCoding>
<name value="ACME Clinical Systems" />
<software value="ACME ePMA" />
<version value="3.5.68 - test" />
<endpoint value="urn:nhs-uk:addressing:ods:T48NT" />
</source>
<reference value="urn:medication-statement-56642" />
</focus>
<reference value="urn:medication-statement-1758563" />
</focus>
<reference value="urn:medication-statement-322236009" />
</focus>
</MessageHeader>
</resource>
</entry>
<fullUrl value="urn:patient-00123943" />
<Patient>
<id value="urn:patient-00123943" />
<system value="https://fhir.nhs.uk/Id/nhs-number" />
<value value="4857773457" />
</identifier>
<use value="official" />
<text value="Miss Cedeep Laya" />
<family value="Laya" />
<given value="Cedeep" />
<prefix value="Miss" />
</name>
<gender value="female" />
<birthDate value="1979-04-13" />
</Patient>
</resource>
</entry>
<fullUrl value="urn:staff-0002" />
<Practitioner>
<id value="urn:staff-0002" />
<text value="Dr Maikeu Better" />
<family value="Better" />
<given value="Maikeu" />
<prefix value="Dr" />
</name>
<system value="https://fhir.hl7.org.uk/Id/gmc-number" />
<code value="2145879" />
<display value="General Medical Council" />
</coding>
</code>
</qualification>
</Practitioner>
</resource>
</entry>
<fullUrl value="urn:medication-222311000001102" />
<Medication>
<id value="urn:medication-222311000001102" />
<system value="http://snomed.info/sct" />
<code value="222311000001102" />
<display value="Ventolin 100micrograms/dose Evohaler (GlaxoSmithKline UK Ltd)" />
</coding>
</code>
</Medication>
</resource>
</entry>
<fullUrl value="urn:medication-statement-56642" />
<MedicationStatement>
<id value="urn:medication-statement-56642" />
<status value="active" />
<system value="http://hl7.org/fhir/medication-request-category" />
<code value="patientspecified" />
<display value="patientspecified" />
</coding>
</category>
<reference value="urn:medication-222311000001102" />
<display value="Ventolin 100micrograms/dose Evohaler (GlaxoSmithKline UK Ltd)" />
</medicationReference>
<reference value="urn:patient-00123943" />
<display value="Miss Cedeep Laya" />
</subject>
<dateAsserted value="2021-05-13T13:47:12+00:00" />
<reference value="urn:staff-0002" />
<display value="Dr Maikeu Better" />
</informationSource>
<frequency value="2" />
<period value="1" />
<periodUnit value="d" />
</repeat>
</timing>
<system value="http://snomed.info/sct" />
<code value="26643006" />
<display value="Oral" />
</coding>
</route>
<value value="2" />
<unit value="dose" />
<system value="http://snomed.info/sct" />
<code value="3317411000001100" />
</doseQuantity>
</doseAndRate>
</dosage>
</MedicationStatement>
</resource>
</entry>
<fullUrl value="urn:medication-3178611000001100" />
<Medication>
<id value="urn:medication-3178611000001100" />
<system value="http://snomed.info/sct" />
<code value="3178611000001100" />
<display value="Becotide 100 inhaler (GlaxoSmithKline UK Ltd)" />
</coding>
</code>
</Medication>
</resource>
</entry>
<fullUrl value="urn:medication-statement-1758563" />
<MedicationStatement>
<id value="urn:medication-statement-1758563" />
<status value="active" />
<system value="http://hl7.org/fhir/medication-request-category" />
<code value="patientspecified" />
<display value="patientspecified" />
</coding>
</category>
<reference value="urn:medication-3178611000001100" />
<display value="Becotide 100 inhaler (GlaxoSmithKline UK Ltd)" />
</medicationReference>
<reference value="urn:patient-00123943" />
<display value="Miss Cedeep Laya" />
</subject>
<dateAsserted value="2021-05-13T13:47:12+00:00" />
<reference value="urn:staff-0002" />
<display value="Dr Maikeu Better" />
</informationSource>
<frequency value="2" />
<period value="1" />
<periodUnit value="d" />
</repeat>
</timing>
<system value="http://snomed.info/sct" />
<code value="26643006" />
<display value="Oral" />
</coding>
</route>
<value value="1" />
<unit value="dose" />
<system value="http://snomed.info/sct" />
<code value="3317411000001100" />
</doseQuantity>
</doseAndRate>
</dosage>
</MedicationStatement>
</resource>
</entry>
<fullUrl value="urn:medication-322236009" />
<Medication>
<id value="urn:medication-322236009" />
<system value="http://snomed.info/sct" />
<code value="42109611000001109" />
<display value="Paracetamol 500mg tablets" />
</coding>
</code>
</Medication>
</resource>
</entry>
<fullUrl value="urn:medication-statement-322236009" />
<MedicationStatement>
<id value="urn:medication-statement-322236009" />
<status value="active" />
<system value="http://hl7.org/fhir/medication-request-category" />
<code value="patientspecified" />
<display value="patientspecified" />
</coding>
</category>
<reference value="urn:medication-322236009" />
<display value="Paracetamol 500mg tablets" />
</medicationReference>
<reference value="urn:patient-00123943" />
<display value="Miss Cedeep Laya" />
</subject>
<dateAsserted value="2021-05-13T13:47:12+00:00" />
<reference value="urn:staff-0002" />
<display value="Dr Maikeu Better" />
</informationSource>
<frequencyMax value="4" />
<period value="1" />
<periodUnit value="d" />
</repeat>
</timing>
<asNeededBoolean value="true" />
<system value="http://snomed.info/sct" />
<code value="26643006" />
<display value="Oral" />
</coding>
</route>
<value value="2" />
<unit value="tablet" />
<system value="http://snomed.info/sct" />
<code value="428673006" />
</doseQuantity>
</doseAndRate>
</dosage>
</MedicationStatement>
</resource>
</entry>
</Bundle>
{
"resourceType": "Bundle",
"id": "7cd3f180-76f7-4bc6-b6d5-e672acd83b81",
"system": "urn:[organisation_name]:[system_name]",
"value": "urn:8cd8108d-8c72-4fe9-a284-cd28b127fcfa"
},
"type": "message",
"timestamp": "2021-05-13T13:47:12+00:00",
"entry": [
{
"fullUrl": "urn:message-header-2123123",
"resourceType": "MessageHeader",
"id": "message-header-2123123",
"system": "http://hl7.org/fhir/message-events",
"code": "current-medication",
"display": "Current Medication"
},
"source": {
"name": "ACME Clinical Systems",
"software": "ACME ePMA",
"version": "3.5.68 - test",
"endpoint": "urn:nhs-uk:addressing:ods:T48NT"
},
"focus": [
{
"reference": "urn:medication-statement-56642"
},
{
"reference": "urn:medication-statement-1758563"
},
{
"reference": "urn:medication-statement-322236009"
}
]
}
},
{
"fullUrl": "urn:patient-00123943",
"resourceType": "Patient",
"id": "urn:patient-00123943",
{
"system": "https://fhir.nhs.uk/Id/nhs-number",
"value": "4857773457"
}
],
"name": [
{
"use": "official",
"text": "Miss Cedeep Laya",
"family": "Laya",
"given": [
"Cedeep"
],
"prefix": [
"Miss"
]
}
],
"gender": "female",
"birthDate": "1979-04-13"
}
},
{
"fullUrl": "urn:staff-0002",
"resourceType": "Practitioner",
"id": "urn:staff-0002",
"name": [
{
"text": "Dr Maikeu Better",
"family": "Better",
"given": [
"Maikeu"
],
"prefix": [
"Dr"
]
}
],
{
"code": {
"coding": [
{
"system": "https://fhir.hl7.org.uk/Id/gmc-number",
"code": "2145879",
"display": "General Medical Council"
}
]
}
}
]
}
},
{
"fullUrl": "urn:medication-222311000001102",
"resourceType": "Medication",
"id": "urn:medication-222311000001102",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "222311000001102",
"display": "Ventolin 100micrograms/dose Evohaler (GlaxoSmithKline UK Ltd)"
}
]
}
}
},
{
"fullUrl": "urn:medication-statement-56642",
"resourceType": "MedicationStatement",
"id": "urn:medication-statement-56642",
"status": "active",
"coding": [
{
"system": "http://hl7.org/fhir/medication-request-category",
"code": "patientspecified",
"display": "patientspecified"
}
]
},
"reference": "urn:medication-222311000001102",
"display": "Ventolin 100micrograms/dose Evohaler (GlaxoSmithKline UK Ltd)"
},
"subject": {
"reference": "urn:patient-00123943",
"display": "Miss Cedeep Laya"
},
"dateAsserted": "2021-05-13T13:47:12+00:00",
"reference": "urn:staff-0002",
"display": "Dr Maikeu Better"
},
"dosage": [
{
"timing": {
"repeat": {
"frequency": 2,
"period": 1,
"periodUnit": "d"
}
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral"
}
]
},
{
"value": 2,
"unit": "dose",
"system": "http://snomed.info/sct",
"code": "3317411000001100"
}
}
]
}
]
}
},
{
"fullUrl": "urn:medication-3178611000001100",
"resourceType": "Medication",
"id": "urn:medication-3178611000001100",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "3178611000001100",
"display": "Becotide 100 inhaler (GlaxoSmithKline UK Ltd)"
}
]
}
}
},
{
"fullUrl": "urn:medication-statement-1758563",
"resourceType": "MedicationStatement",
"id": "urn:medication-statement-1758563",
"status": "active",
"coding": [
{
"system": "http://hl7.org/fhir/medication-request-category",
"code": "patientspecified",
"display": "patientspecified"
}
]
},
"reference": "urn:medication-3178611000001100",
"display": "Becotide 100 inhaler (GlaxoSmithKline UK Ltd)"
},
"subject": {
"reference": "urn:patient-00123943",
"display": "Miss Cedeep Laya"
},
"dateAsserted": "2021-05-13T13:47:12+00:00",
"reference": "urn:staff-0002",
"display": "Dr Maikeu Better"
},
"dosage": [
{
"timing": {
"repeat": {
"frequency": 2,
"period": 1,
"periodUnit": "d"
}
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral"
}
]
},
{
"value": 1,
"unit": "dose",
"system": "http://snomed.info/sct",
"code": "3317411000001100"
}
}
]
}
]
}
},
{
"fullUrl": "urn:medication-322236009",
"resourceType": "Medication",
"id": "urn:medication-322236009",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "42109611000001109",
"display": "Paracetamol 500mg tablets"
}
]
}
}
},
{
"fullUrl": "urn:medication-statement-322236009",
"resourceType": "MedicationStatement",
"id": "urn:medication-statement-322236009",
"status": "active",
"coding": [
{
"system": "http://hl7.org/fhir/medication-request-category",
"code": "patientspecified",
"display": "patientspecified"
}
]
},
"reference": "urn:medication-322236009",
"display": "Paracetamol 500mg tablets"
},
"subject": {
"reference": "urn:patient-00123943",
"display": "Miss Cedeep Laya"
},
"dateAsserted": "2021-05-13T13:47:12+00:00",
"reference": "urn:staff-0002",
"display": "Dr Maikeu Better"
},
"dosage": [
{
"timing": {
"repeat": {
"period": 1,
"periodUnit": "d"
}
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral"
}
]
},
{
"value": 2,
"unit": "tablet",
"system": "http://snomed.info/sct",
"code": "428673006"
}
}
]
}
]
}
}
]
}
Bundle.id[0]7cd3f180-76f7-4bc6-b6d5-e672acd83b81
Bundle.identifier[0].system[0]urn:[organisation_name]:[system_name]
Bundle.identifier[0].value[0]urn:8cd8108d-8c72-4fe9-a284-cd28b127fcfa
Bundle.type[0]message
Bundle.timestamp[0]2021-05-13T13:47:12+00:00
Bundle.entry[0].fullUrl[0]urn:message-header-2123123
Bundle.entry[0].resource[0].id[0]message-header-2123123
Bundle.entry[0].resource[0].event[0].system[0]http://hl7.org/fhir/message-events
Bundle.entry[0].resource[0].event[0].code[0]current-medication
Bundle.entry[0].resource[0].event[0].display[0]Current Medication
Bundle.entry[0].resource[0].source[0].name[0]ACME Clinical Systems
Bundle.entry[0].resource[0].source[0].software[0]ACME ePMA
Bundle.entry[0].resource[0].source[0].version[0]3.5.68 - test
Bundle.entry[0].resource[0].source[0].endpoint[0]urn:nhs-uk:addressing:ods:T48NT
Bundle.entry[0].resource[0].focus[0].reference[0]urn:medication-statement-56642
Bundle.entry[0].resource[0].focus[1].reference[0]urn:medication-statement-1758563
Bundle.entry[0].resource[0].focus[2].reference[0]urn:medication-statement-322236009
Bundle.entry[1].fullUrl[0]urn:patient-00123943
Bundle.entry[1].resource[0].id[0]urn:patient-00123943
Bundle.entry[1].resource[0].identifier[0].system[0]https://fhir.nhs.uk/Id/nhs-number
Bundle.entry[1].resource[0].identifier[0].value[0]4857773457
Bundle.entry[1].resource[0].name[0].use[0]official
Bundle.entry[1].resource[0].name[0].text[0]Miss Cedeep Laya
Bundle.entry[1].resource[0].name[0].family[0]Laya
Bundle.entry[1].resource[0].name[0].given[0]Cedeep
Bundle.entry[1].resource[0].name[0].prefix[0]Miss
Bundle.entry[1].resource[0].gender[0]female
Bundle.entry[1].resource[0].birthDate[0]1979-04-13
Bundle.entry[2].fullUrl[0]urn:staff-0002
Bundle.entry[2].resource[0].id[0]urn:staff-0002
Bundle.entry[2].resource[0].name[0].text[0]Dr Maikeu Better
Bundle.entry[2].resource[0].name[0].family[0]Better
Bundle.entry[2].resource[0].name[0].given[0]Maikeu
Bundle.entry[2].resource[0].name[0].prefix[0]Dr
Bundle.entry[2].resource[0].qualification[0].code[0].coding[0].system[0]https://fhir.hl7.org.uk/Id/gmc-number
Bundle.entry[2].resource[0].qualification[0].code[0].coding[0].code[0]2145879
Bundle.entry[2].resource[0].qualification[0].code[0].coding[0].display[0]General Medical Council
Bundle.entry[3].fullUrl[0]urn:medication-222311000001102
Bundle.entry[3].resource[0].id[0]urn:medication-222311000001102
Bundle.entry[3].resource[0].code[0].coding[0].system[0]http://snomed.info/sct
Bundle.entry[3].resource[0].code[0].coding[0].code[0]222311000001102
Bundle.entry[3].resource[0].code[0].coding[0].display[0]Ventolin 100micrograms/dose Evohaler (GlaxoSmithKline UK Ltd)
Bundle.entry[4].fullUrl[0]urn:medication-statement-56642
Bundle.entry[4].resource[0].id[0]urn:medication-statement-56642
Bundle.entry[4].resource[0].status[0]active
Bundle.entry[4].resource[0].category[0].coding[0].system[0]http://hl7.org/fhir/medication-request-category
Bundle.entry[4].resource[0].category[0].coding[0].code[0]patientspecified
Bundle.entry[4].resource[0].category[0].coding[0].display[0]patientspecified
Bundle.entry[4].resource[0].medication[0].reference[0]urn:medication-222311000001102
Bundle.entry[4].resource[0].medication[0].display[0]Ventolin 100micrograms/dose Evohaler (GlaxoSmithKline UK Ltd)
Bundle.entry[4].resource[0].subject[0].reference[0]urn:patient-00123943
Bundle.entry[4].resource[0].subject[0].display[0]Miss Cedeep Laya
Bundle.entry[4].resource[0].dateAsserted[0]2021-05-13T13:47:12+00:00
Bundle.entry[4].resource[0].informationSource[0].reference[0]urn:staff-0002
Bundle.entry[4].resource[0].informationSource[0].display[0]Dr Maikeu Better
Bundle.entry[4].resource[0].dosage[0].timing[0].repeat[0].frequency[0]2
Bundle.entry[4].resource[0].dosage[0].timing[0].repeat[0].period[0]1
Bundle.entry[4].resource[0].dosage[0].timing[0].repeat[0].periodUnit[0]d
Bundle.entry[4].resource[0].dosage[0].route[0].coding[0].system[0]http://snomed.info/sct
Bundle.entry[4].resource[0].dosage[0].route[0].coding[0].code[0]26643006
Bundle.entry[4].resource[0].dosage[0].route[0].coding[0].display[0]Oral
Bundle.entry[4].resource[0].dosage[0].doseAndRate[0].dose[0].value[0]2
Bundle.entry[4].resource[0].dosage[0].doseAndRate[0].dose[0].unit[0]dose
Bundle.entry[4].resource[0].dosage[0].doseAndRate[0].dose[0].system[0]http://snomed.info/sct
Bundle.entry[4].resource[0].dosage[0].doseAndRate[0].dose[0].code[0]3317411000001100
Bundle.entry[5].fullUrl[0]urn:medication-3178611000001100
Bundle.entry[5].resource[0].id[0]urn:medication-3178611000001100
Bundle.entry[5].resource[0].code[0].coding[0].system[0]http://snomed.info/sct
Bundle.entry[5].resource[0].code[0].coding[0].code[0]3178611000001100
Bundle.entry[5].resource[0].code[0].coding[0].display[0]Becotide 100 inhaler (GlaxoSmithKline UK Ltd)
Bundle.entry[6].fullUrl[0]urn:medication-statement-1758563
Bundle.entry[6].resource[0].id[0]urn:medication-statement-1758563
Bundle.entry[6].resource[0].status[0]active
Bundle.entry[6].resource[0].category[0].coding[0].system[0]http://hl7.org/fhir/medication-request-category
Bundle.entry[6].resource[0].category[0].coding[0].code[0]patientspecified
Bundle.entry[6].resource[0].category[0].coding[0].display[0]patientspecified
Bundle.entry[6].resource[0].medication[0].reference[0]urn:medication-3178611000001100
Bundle.entry[6].resource[0].medication[0].display[0]Becotide 100 inhaler (GlaxoSmithKline UK Ltd)
Bundle.entry[6].resource[0].subject[0].reference[0]urn:patient-00123943
Bundle.entry[6].resource[0].subject[0].display[0]Miss Cedeep Laya
Bundle.entry[6].resource[0].dateAsserted[0]2021-05-13T13:47:12+00:00
Bundle.entry[6].resource[0].informationSource[0].reference[0]urn:staff-0002
Bundle.entry[6].resource[0].informationSource[0].display[0]Dr Maikeu Better
Bundle.entry[6].resource[0].dosage[0].timing[0].repeat[0].frequency[0]2
Bundle.entry[6].resource[0].dosage[0].timing[0].repeat[0].period[0]1
Bundle.entry[6].resource[0].dosage[0].timing[0].repeat[0].periodUnit[0]d
Bundle.entry[6].resource[0].dosage[0].route[0].coding[0].system[0]http://snomed.info/sct
Bundle.entry[6].resource[0].dosage[0].route[0].coding[0].code[0]26643006
Bundle.entry[6].resource[0].dosage[0].route[0].coding[0].display[0]Oral
Bundle.entry[6].resource[0].dosage[0].doseAndRate[0].dose[0].value[0]1
Bundle.entry[6].resource[0].dosage[0].doseAndRate[0].dose[0].unit[0]dose
Bundle.entry[6].resource[0].dosage[0].doseAndRate[0].dose[0].system[0]http://snomed.info/sct
Bundle.entry[6].resource[0].dosage[0].doseAndRate[0].dose[0].code[0]3317411000001100
Bundle.entry[7].fullUrl[0]urn:medication-322236009
Bundle.entry[7].resource[0].id[0]urn:medication-322236009
Bundle.entry[7].resource[0].code[0].coding[0].system[0]http://snomed.info/sct
Bundle.entry[7].resource[0].code[0].coding[0].code[0]42109611000001109
Bundle.entry[7].resource[0].code[0].coding[0].display[0]Paracetamol 500mg tablets
Bundle.entry[8].fullUrl[0]urn:medication-statement-322236009
Bundle.entry[8].resource[0].id[0]urn:medication-statement-322236009
Bundle.entry[8].resource[0].status[0]active
Bundle.entry[8].resource[0].category[0].coding[0].system[0]http://hl7.org/fhir/medication-request-category
Bundle.entry[8].resource[0].category[0].coding[0].code[0]patientspecified
Bundle.entry[8].resource[0].category[0].coding[0].display[0]patientspecified
Bundle.entry[8].resource[0].medication[0].reference[0]urn:medication-322236009
Bundle.entry[8].resource[0].medication[0].display[0]Paracetamol 500mg tablets
Bundle.entry[8].resource[0].subject[0].reference[0]urn:patient-00123943
Bundle.entry[8].resource[0].subject[0].display[0]Miss Cedeep Laya
Bundle.entry[8].resource[0].dateAsserted[0]2021-05-13T13:47:12+00:00
Bundle.entry[8].resource[0].informationSource[0].reference[0]urn:staff-0002
Bundle.entry[8].resource[0].informationSource[0].display[0]Dr Maikeu Better
Bundle.entry[8].resource[0].dosage[0].timing[0].repeat[0].frequencyMax[0]4
Bundle.entry[8].resource[0].dosage[0].timing[0].repeat[0].period[0]1
Bundle.entry[8].resource[0].dosage[0].timing[0].repeat[0].periodUnit[0]d
Bundle.entry[8].resource[0].dosage[0].asNeeded[0]True
Bundle.entry[8].resource[0].dosage[0].route[0].coding[0].system[0]http://snomed.info/sct
Bundle.entry[8].resource[0].dosage[0].route[0].coding[0].code[0]26643006
Bundle.entry[8].resource[0].dosage[0].route[0].coding[0].display[0]Oral
Bundle.entry[8].resource[0].dosage[0].doseAndRate[0].dose[0].value[0]2
Bundle.entry[8].resource[0].dosage[0].doseAndRate[0].dose[0].unit[0]tablet
Bundle.entry[8].resource[0].dosage[0].doseAndRate[0].dose[0].system[0]http://snomed.info/sct
Bundle.entry[8].resource[0].dosage[0].doseAndRate[0].dose[0].code[0]428673006
Bundle

back to top