MedicationAdministration
Overview
The Medication Administration resource provides information about medications and vaccines administered to a patient or consumed by a patient including injections, intravenous solutions, and self administered oral medications.
- IMPORTANT NOTE: Infuse or Bolus administration results for continuous infusion orders may require additional calculations to determine the actual amount of medication administered per ingredient. An additional calculation is required when the dosage dose does not equal the contained Medication ingredient strength denominator. In this case, calculate the ratio between the ingredient’s numerator divided by the denominator and multiply by dosage dose. This will be the actual amount of medication administered.
The following fields are returned if valued:
- MedicationAdministration id
- Infuse Over Time Extension
- Status
- StatusReason
- Medication
- Subject
- Context
- Effective
- Performer
- Request
- Note
- Dosage
Terminology Bindings
| MedicationAdministration.status |
|
| MedicationAdministration.statusReason |
|
| MedicationAdministration.medicationCodeableConcept |
|
| MedicationAdministration.performer.function |
|
| MedicationAdministration.dosage.site |
|
| MedicationAdministration.dosage.route |
|
Contained Medication Bindings
| Medication.code |
|
Extensions
Custom Extensions
All URLs for custom extensions are defined as https://fhir-ehr.cerner.com/r4/StructureDefinition/{id}
| ID | Value[x] Type | Description |
|---|---|---|
infuse-over-time |
Quantity |
The length of time in minutes it took to infuse a medication. |
Search
Search for MedicationAdministrations that meet supplied query parameters:
GET /MedicationAdministration?:parameters
Implementation Notes
-
MedicationAdministration.medication may be a reference to a contained Medication when the Medication cannot be represented by a CodeableConcept because it contains a unique combination of ingredients. Medications in the system always exist within the context of a MedicationAdministration and cannot be referenced independently.
-
IMPORTANT NOTE: Infuse or Bolus administration results for continuous infusion orders may require additional calculations to determine the actual amount of medication administered per ingredient. An additional calculation is required when the dosage dose does not equal the contained Medication ingredient strength denominator. In this case, calculate the ratio between the ingredient’s numerator divided by the denominator and multiply by dosage dose. This will be the actual amount of medication administered.
Authorization Types
Parameters
| Name | Required? | Type | Description |
|---|---|---|---|
_id |
This, or patient
|
token |
The logical resource id associated with the resource. Example: _id=12345
|
patient |
This, or _id
|
reference |
The specific patient to return MedicationAdministrations for. Example: patient=1234
|
status |
N | token |
The [status] of the medication administration event. May be a list separated by commas. Example: status=completed,not-done
|
performer |
N | reference |
The identity of the individual who administered the medication. May be a list separated by commas. Example: performer=1245,7659
|
effective-time |
N | date |
An date-time range when administration happened. Must include a time. Example: effective-time=ge2014-05-19T20:54:02.000Z
|
_count |
N | number |
The maximum number of results to include in a page. Example: 50
|
Notes:
-
effective-timeparameter may be provided- once with a prefix
georgtorleorlt. Example:effective-time=ge2014-05-19T20:54:02.000Z - twice with the prefixes
ge,gt,le,lt. Example:effective-time=ge2014-05-19T20:54:02.000Z&effective-time=le2014-05-20T20:54:02.000Z
- once with a prefix
Headers
Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>Example
Request
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12740087
Response
Status: 200 OK{
"resourceType": "Bundle",
"id": "b630105a-2ec0-4877-8f8c-3b26b53cacd9",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12740087"
},
{
"relation": "next",
"url": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12740087\n &-pageContext=H4sIAAAAAAAAADWMOw7CMBAF7-IaWTEK_myHgDKpUtAhs95ACm8i49Ag7s4ixOueZjQvtcQbKVD96TyojbxCXDtK-\n 5QnPqx1Hkeha2FAKkwF8pQA77FUTU9RAU1ojf7CS7wi658WH4vGOYMJbuudNVbaxOlYh_yPmp33tnGhbWTvD51Gp0KJAAAA&\n -pageDirection=NEXT"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197287785",
"resource": {
"resourceType": "MedicationAdministration",
"id": "197287785",
"meta": {
"versionId": "197287788",
"lastUpdated": "2020-05-11T21:29:30.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns='http://www.w3.org/1999/xhtml'><p><b>Medication Administration</b></p>\n <p><b>Patient</b>: PWDOSEMERX, PWDOSEMERX ONE</p><p><b>Medication</b>\n : potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl</p>\n <p><b>Dosage</b>: 250 milliliter (iso1000)</p><p><b>Status</b>: Completed</p>\n <p><b>Effective Time</b>: May 11, 2020 9:27 P.M. UTC</p></div>"
},
"contained": [
{
"resourceType": "Medication",
"id": "197287785",
"code": {
"text": "potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl"
},
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "237381",
"display": "Potassium Acetate 2 MEQ/ML Injectable Solution",
"userSelected": false
}
],
"text": "potassium acetate"
},
"strength": {
"numerator": {
"value": 40,
"unit": "milliequivalents (chemical)",
"system": "http://unitsofmeasure.org",
"code": "meq"
},
"denominator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "204520",
"display": "Potassium Chloride 2 MEQ/ML Injectable Solution",
"userSelected": false
}
],
"text": "K-Sol"
},
"strength": {
"numerator": {
"value": 40,
"unit": "milliequivalents (chemical)",
"system": "http://unitsofmeasure.org",
"code": "meq"
},
"denominator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "245220",
"display": "Glucose 100 MG/ML / Sodium Chloride 0.0342 MEQ/ML Injectable Solution",
"userSelected": false
}
],
"text": "Dextrose 10% with 0.2% NaCl"
},
"strength": {
"numerator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
}
]
}
],
"extension": [
{
"valueQuantity": {
"value": 120.0,
"unit": "minutes",
"system": "http://unitsofmeasure.org",
"code": "min"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/infuse-over-time"
}
],
"status": "completed",
"medicationReference": {
"reference": "#197287785",
"display": "potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl"
},
"subject": {
"reference": "Patient/12740087",
"display": "PWDOSEMERX, PWDOSEMERX ONE"
},
"context": {
"reference": "Encounter/97949818"
},
"effectiveDateTime": "2020-05-11T21:27:00.000Z",
"performer": [
{
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/med-admin-perform-function",
"code": "performer",
"display": "Performer"
}
],
"text": "Performer"
},
"actor": {
"reference": "Practitioner/607928",
"display": "Cerner Test, RN Cerner"
}
}
],
"request": {
"reference": "MedicationRequest/311887733"
},
"dosage": {
"site": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "66480008",
"display": "Structure of left forearm (body structure)",
"userSelected": false
}
],
"text": "Arm, Lower, Left"
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "47625008",
"display": "Intravenous route (qualifier value)",
"userSelected": false
}
],
"text": "IV Piggyback"
},
"dose": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"rateQuantity": {
"value": 125.0,
"unit": "milliliter per hour",
"system": "http://unitsofmeasure.org",
"code": "mL/h"
}
}
}
},
{
"fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197287732",
"resource": {
"resourceType": "MedicationAdministration",
"id": "197287732",
"meta": {
"versionId": "197287733",
"lastUpdated": "2020-05-04T20:40:29.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns='http://www.w3.org/1999/xhtml'><p><b>Medication Administration</b></p>\n <p><b>Patient</b>: PWDOSEMERX, PWDOSEMERX ONE</p><p><b>Medication</b>: amoxicillin</p>\n <p><b>Status</b>: Not Done</p><p><b>Effective Time</b>: May 5, 2020 1:00 P.M. UTC</p></div>"
},
"status": "not-done",
"statusReason": [
{
"text": "Not Done: Change in Patient Status"
}
],
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "723",
"display": "Amoxicillin",
"userSelected": false
}
],
"text": "amoxicillin"
},
"subject": {
"reference": "Patient/12740087",
"display": "PWDOSEMERX, PWDOSEMERX ONE"
},
"context": {
"reference": "Encounter/97949818"
},
"effectiveDateTime": "2020-05-05T13:00:00.000Z",
"performer": [
{
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/med-admin-perform-function",
"code": "performer",
"display": "Performer"
}
],
"text": "Performer"
},
"actor": {
"reference": "Practitioner/607928",
"display": "Cerner Test, RN Cerner"
}
}
],
"request": {
"reference": "MedicationRequest/311662377"
},
"note": [
{
"authorReference": {
"reference": "Practitioner/607928"
},
"time": "2020-05-04T20:40:29.000Z",
"text": "This is a not done comment.\\n"
},
{
"text": "This is an order comment"
}
]
}
}
]
}Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.
Retrieve by id
List an individual MedicationAdministration by its id:
GET /MedicationAdministration/:id
Implementation Notes
-
MedicationAdministration.medication may be a reference to a contained Medication when the Medication cannot be represented by a CodeableConcept because it contains a unique combination of ingredients. Medications in the system always exist within the context of a MedicationAdministration and cannot be be referenced independently.
-
IMPORTANT NOTE: Infuse or Bolus administration results for continuous infusion orders may require additional calculations to determine the actual amount of medication administered per ingredient. An additional calculation is required when the dosage dose does not equal the contained Medication ingredient strength denominator. In this case, calculate the ratio between the ingredient’s numerator divided by the denominator and multiply by dosage dose. This will be the actual amount of medication administered.
Authorization Types
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>Example
Request
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197287785
Response
Status: 200 OK{
"resourceType": "MedicationAdministration",
"id": "197287785",
"meta": {
"versionId": "197287788",
"lastUpdated": "2020-05-11T21:29:30.000Z"
},
"text": {
"status": "generated",
"div": "<div xmlns='http://www.w3.org/1999/xhtml'><p><b>Medication Administration</b></p>\n <p><b>Patient</b>: PWDOSEMERX, PWDOSEMERX ONE</p><p><b>Medication</b>\n : potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl</p>\n <p><b>Dosage</b>: 250 milliliter (iso1000)</p><p><b>Status</b>: Completed</p>\n <p><b>Effective Time</b>: May 11, 2020 9:27 P.M. UTC</p></div>"
},
"contained": [
{
"resourceType": "Medication",
"id": "197287785",
"code": {
"text": "potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl"
},
"ingredient": [
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "237381",
"display": "Potassium Acetate 2 MEQ/ML Injectable Solution",
"userSelected": false
}
],
"text": "potassium acetate"
},
"strength": {
"numerator": {
"value": 40,
"unit": "milliequivalents (chemical)",
"system": "http://unitsofmeasure.org",
"code": "meq"
},
"denominator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "204520",
"display": "Potassium Chloride 2 MEQ/ML Injectable Solution",
"userSelected": false
}
],
"text": "K-Sol"
},
"strength": {
"numerator": {
"value": 40,
"unit": "milliequivalents (chemical)",
"system": "http://unitsofmeasure.org",
"code": "meq"
},
"denominator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"itemCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "245220",
"display": "Glucose 100 MG/ML / Sodium Chloride 0.0342 MEQ/ML Injectable Solution",
"userSelected": false
}
],
"text": "Dextrose 10% with 0.2% NaCl"
},
"strength": {
"numerator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
}
]
}
],
"extension": [
{
"valueQuantity": {
"value": 120.0,
"unit": "minutes",
"system": "http://unitsofmeasure.org",
"code": "min"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/infuse-over-time"
}
],
"status": "completed",
"medicationReference": {
"reference": "#197287785",
"display": "potassium acetate + K-Sol + Dextrose 10% with 0.2% NaCl"
},
"subject": {
"reference": "Patient/12740087",
"display": "PWDOSEMERX, PWDOSEMERX ONE"
},
"context": {
"reference": "Encounter/97949818"
},
"effectiveDateTime": "2020-05-11T21:27:00.000Z",
"performer": [
{
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/med-admin-perform-function",
"code": "performer",
"display": "Performer"
}
],
"text": "Performer"
},
"actor": {
"reference": "Practitioner/607928",
"display": "Cerner Test, RN Cerner"
}
}
],
"request": {
"reference": "MedicationRequest/311887733"
},
"dosage": {
"site": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "66480008",
"display": "Structure of left forearm (body structure)",
"userSelected": false
}
],
"text": "Arm, Lower, Left"
},
"route": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "47625008",
"display": "Intravenous route (qualifier value)",
"userSelected": false
}
],
"text": "IV Piggyback"
},
"dose": {
"value": 250,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"rateQuantity": {
"value": 125.0,
"unit": "milliliter per hour",
"system": "http://unitsofmeasure.org",
"code": "mL/h"
}
}
}Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.