MedicationAdministration
Overview
The MedicationAdministration resource provides information about medications administered to a patient or consumed by a patient including injections, intravenous solutions, and self-administered oral medications. You can use this resource to search for full administration details for vaccinations administered by the current healthcare system. For historically administered vaccines, or vaccines administered by other healthcare disciplines, care settings, or regions, you must use the Immunization
resource to create or retrieve information.
- Important: 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 result is 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
- 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 in the context of a medication administration and cannot be referenced independently.
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.
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 medication administrations that meet supplied query parameters.
GET /MedicationAdministration?:parameters
Authorization Types
Parameters
Name | Required? | Type | Description |
---|---|---|---|
_id |
Conditionally | token |
The logical resource ID associated with the resource. It may be a list separated by commas. This parameter is required if the patient parameter is not used. Example: _id=12345
|
patient |
Conditionally | reference |
The specific patient to return medication administrations for. This parameter is required if the _id parameter is not used. Example: patient=1234
|
status |
No | token |
The status of the medication administration event. It may be a list separated by commas. Example: status=completed,not-done
|
performer |
No | reference |
The logical resource ID of the practitioner who administered the medication. It may be a list separated by commas. Example: performer=1245,7659
|
effective-time |
No | dateTime |
A date range for when the administration happened. Example: effective-time=ge2014-05-19T20:54:02.000Z
|
_count |
No | number |
The maximum number of results to include on a page. Example: 50
|
Notes
- When searching with the
_id
parameter- It must not be provided with any other parameters.
- When searching with the
effective-time
parameter:- For a single
effective-time
occurrence:- It must be provided with a
ge
,gt
,le
, orlt
prefix to imply the date range for an administrations search. - The time component is required.
- Example:
effective-time=ge2014-05-19T20:54:02.000Z
- It must be provided with a
- For two
effective-time
occurences:- It must be provided once with the
le
orlt
prefix, and once with thege
orgt
prefix to search for administrations within the given upper and lower timestamps, respectively. - The time component is required for both parameters.
- Example:
effective-time=ge2014-05-19T20:54:02.000Z&effective-time=le2014-05-20T20:54:02.000Z
- It must be provided once with the
- For a single
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"
}
]
}
}
]
}
Retrieve by ID
List an individual medication administration by its ID.
GET /MedicationAdministration/:id
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"
}
}
}