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 adminstered by other healthcare disciplines, care settings, or regions, you must use the Immunization
resource to 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 quantity. This result is the actual amount of medication administered.
The following fields are returned if valued:
- Medication Administration id
- Infuse Over Time Extension
- Status
- Patient
- Practitioner
- Encounter
- Prescription
- Effective Time
- Medication
- Details of medication administered:
- 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.medicationCodeableConcept |
|
MedicationAdministration.dosage.siteCodeableConcept |
|
MedicationAdministration.dosage.route |
|
Contained Medication Bindings
Medication.code |
|
Extensions
Custom Extensions
All URLs for custom extensions are defined as https://fhir-ehr.cerner.com/dstu2/StructureDefinition/{id}
For more information, see the StructureDefinition
resource.
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
|
practitioner |
No | reference |
The logical resource ID of the practitioner who administered the medication. It may be a list separated by commas. Example: practitioner=1245,7659
|
notgiven |
No | token |
Administrations that were not made. A value of true includes these administrations in the search results, and a value of false excludes them. |
effectivetime |
No | dateTime |
A date range for when the administration happened. Example: effectivetime=ge2014-05-19T20:54:02.000Z
|
_count |
No | number |
The maximum number of results to return. Example: _count=50
|
Notes
- When searching with the
_id
parameter:- It must not be provided with any other parameters.
- When searching with the
effectivetime
parameter:- For a single
effectivetime
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:
effectivetime=ge2014-05-19T20:54:02.000Z
- It must be provided with a
- For two
effectivetime
occurences:- It must be provided with
le
orlt
andge
orgt
prefixes to search for administrations within a specific range. - The time component is required for both parameters.
- Example:
effectivetime=ge2014-05-19T20:54:02.000Z&effectivetime=le2014-05-20T20:54:02.000Z
- It must be provided with
- For a single
Headers
Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12724066
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "b3e1848e-92db-482f-a7b1-62808aacd8ec",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?patient=12724066"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197292849",
"resource": {
"resourceType": "MedicationAdministration",
"id": "197292849",
"meta": {
"versionId": "197292850",
"lastUpdated": "2020-07-06T21:13:24.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: SMART, NANCY</p><p><b>Medication Display</b>: acetaminophen</p><p><b>Administered</b>: Yes</p><p><b>Dosage Quantity</b>: 650 mg</p><p><b>Medication Status</b>: Completed</p><p><b>Effective Time</b>: Jul 6, 2020 9:11 P.M. UTC</p></div>"
},
"extension": [
{
"url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/infuse-over-time",
"valueQuantity": {
"value": 6.0,
"unit": "minutes",
"system": "http://unitsofmeasure.org",
"code": "min"
}
}
],
"status": "completed",
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"practitioner": {
"reference": "Practitioner/12724064",
"display": "Spence, Open Platform IA, Stephen"
},
"encounter": {
"reference": "Encounter/97953477"
},
"prescription": {
"reference": "MedicationOrder/313764715"
},
"wasNotGiven": false,
"effectiveTimeDateTime": "2020-07-06T21:11:00.000Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "313782",
"display": "Acetaminophen 325 MG Oral Tablet",
"userSelected": false
}
],
"text": "acetaminophen"
},
"dosage": {
"route": {
"coding": [
{
"system": "http://ncimeta.nci.nih.gov",
"code": "C38288",
"display": "ORAL",
"userSelected": false
},
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route (qualifier value)",
"userSelected": false
}
],
"text": "Oral"
},
"quantity": {
"value": 650,
"unit": "mg",
"system": "http://unitsofmeasure.org",
"code": "mg"
}
}
}
}
]
}
Request
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?_id=197375293
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "6a897d29-daca-4f04-b6f5-7e2cdec12f09",
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration?_id=197375293"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197375293",
"resource": {
"resourceType": "MedicationAdministration",
"id": "197375293",
"meta": {
"versionId": "197375292",
"lastUpdated": "2020-09-24T13:41:07.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: TEST, BOB</p><p><b>Medication Display</b>: Dopamine Hydrochloride 80 MG/ML Injection</p><p><b>Administered</b>: Yes</p><p><b>Dosage Quantity</b>: 12.76 milliliter (iso1000)</p><p><b>Medication Status</b>: Completed</p><p><b>Effective Start Time</b>: Sep 24, 2020 2:00 P.M. UTC</p><p><b>Effective End Time</b>: Sep 24, 2020 2:59 P.M. UTC</p></div>"
},
"extension": [
{
"url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/infuse-over-time",
"valueQuantity": {
"value": 6.0,
"unit": "minutes",
"system": "http://unitsofmeasure.org",
"code": "min"
}
}
],
"contained": [
{
"resourceType": "Medication",
"id": "197375293",
"product": {
"ingredient": [
{
"item": {
"reference": "#197375295-1",
"display": "Dopamine Hydrochloride 80 MG/ML Injection"
},
"amount": {
"numerator": {
"value": 400,
"unit": "milligram (mass)",
"system": "http://unitsofmeasure.org",
"code": "mg"
},
"denominator": {
"value": 500,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"item": {
"reference": "#197375297-2",
"display": "50 ML Glucose 50 MG/ML Injection"
},
"amount": {
"numerator": {
"value": 500,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 500,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
}
]
}
},
{
"resourceType": "Medication",
"id": "197375295-1",
"code": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "1743951",
"display": "Dopamine Hydrochloride 80 MG/ML Injection",
"userSelected": false
}
],
"text": "DOPamine"
}
},
{
"resourceType": "Medication",
"id": "197375297-2",
"code": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "1795616",
"display": "50 ML Glucose 50 MG/ML Injection",
"userSelected": false
}
],
"text": "Dextrose 5% in Water"
}
}
],
"status": "completed",
"patient": {
"reference": "Patient/12545984",
"display": "TEST, BOB"
},
"practitioner": {
"reference": "Practitioner/1",
"display": "SYSTEM, SYSTEM Cerner"
},
"encounter": {
"reference": "Encounter/97887460"
},
"prescription": {
"reference": "MedicationOrder/316367035"
},
"wasNotGiven": false,
"effectiveTimePeriod": {
"start": "2020-09-24T14:00:00.000Z",
"end": "2020-09-24T14:59:00.000Z"
},
"medicationReference": {
"reference": "#197375293",
"display": "Dopamine Hydrochloride 80 MG/ML Injection"
},
"dosage": {
"siteCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "66480008",
"display": "Structure of left forearm (body structure)",
"userSelected": false
}
],
"text": "Arm, Lower, Left"
},
"quantity": {
"value": 12.76,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"rateRatio": {
"numerator": {
"value": 12.76,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 1,
"unit": "hour (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "h"
}
}
}
}
}
]
}
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/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197292849
Response
Status: 200 OK
{
"resourceType": "MedicationAdministration",
"id": "197292849",
"meta": {
"versionId": "197292850",
"lastUpdated": "2020-07-06T21:13:24.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: SMART, NANCY</p><p><b>Medication Display</b>: acetaminophen</p><p><b>Administered</b>: Yes</p><p><b>Dosage Quantity</b>: 650 mg</p><p><b>Medication Status</b>: Completed</p><p><b>Effective Time</b>: Jul 6, 2020 9:11 P.M. UTC</p></div>"
},
"extension": [
{
"url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/infuse-over-time",
"valueQuantity": {
"value": 6.0,
"unit": "minutes",
"system": "http://unitsofmeasure.org",
"code": "min"
}
}
],
"status": "completed",
"patient": {
"reference": "Patient/12724066",
"display": "SMART, NANCY"
},
"practitioner": {
"reference": "Practitioner/12724064",
"display": "Spence, Open Platform IA, Stephen"
},
"encounter": {
"reference": "Encounter/97953477"
},
"prescription": {
"reference": "MedicationOrder/313764715"
},
"wasNotGiven": false,
"effectiveTimeDateTime": "2020-07-06T21:11:00.000Z",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "313782",
"display": "Acetaminophen 325 MG Oral Tablet",
"userSelected": false
}
],
"text": "acetaminophen"
},
"dosage": {
"route": {
"coding": [
{
"system": "http://ncimeta.nci.nih.gov",
"code": "C38288",
"display": "ORAL",
"userSelected": false
},
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route (qualifier value)",
"userSelected": false
}
],
"text": "Oral"
},
"quantity": {
"value": 650,
"unit": "mg",
"system": "http://unitsofmeasure.org",
"code": "mg"
}
}
}
Request
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/MedicationAdministration/197375293
Response
Status: 200 OK
{
"resourceType": "MedicationAdministration",
"id": "197375293",
"meta": {
"versionId": "197375292",
"lastUpdated": "2020-09-24T13:41:07.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: TEST, BOB</p><p><b>Medication Display</b>: Dopamine Hydrochloride 80 MG/ML Injection</p><p><b>Administered</b>: Yes</p><p><b>Dosage Quantity</b>: 12.76 milliliter (iso1000)</p><p><b>Medication Status</b>: Completed</p><p><b>Effective Start Time</b>: Sep 24, 2020 2:00 P.M. UTC</p><p><b>Effective End Time</b>: Sep 24, 2020 2:59 P.M. UTC</p></div>"
},
"extension": [
{
"url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/infuse-over-time",
"valueQuantity": {
"value": 6.0,
"unit": "minutes",
"system": "http://unitsofmeasure.org",
"code": "min"
}
}
],
"contained": [
{
"resourceType": "Medication",
"id": "197375293",
"product": {
"ingredient": [
{
"item": {
"reference": "#197375295-1",
"display": "Dopamine Hydrochloride 80 MG/ML Injection"
},
"amount": {
"numerator": {
"value": 400,
"unit": "milligram (mass)",
"system": "http://unitsofmeasure.org",
"code": "mg"
},
"denominator": {
"value": 500,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
},
{
"item": {
"reference": "#197375297-2",
"display": "50 ML Glucose 50 MG/ML Injection"
},
"amount": {
"numerator": {
"value": 500,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 500,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
}
}
}
]
}
},
{
"resourceType": "Medication",
"id": "197375295-1",
"code": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "1743951",
"display": "Dopamine Hydrochloride 80 MG/ML Injection",
"userSelected": false
}
],
"text": "DOPamine"
}
},
{
"resourceType": "Medication",
"id": "197375297-2",
"code": {
"coding": [
{
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
"code": "1795616",
"display": "50 ML Glucose 50 MG/ML Injection",
"userSelected": false
}
],
"text": "Dextrose 5% in Water"
}
}
],
"status": "completed",
"patient": {
"reference": "Patient/12545984",
"display": "TEST, BOB"
},
"practitioner": {
"reference": "Practitioner/1",
"display": "SYSTEM, SYSTEM Cerner"
},
"encounter": {
"reference": "Encounter/97887460"
},
"prescription": {
"reference": "MedicationOrder/316367035"
},
"wasNotGiven": false,
"effectiveTimePeriod": {
"start": "2020-09-24T14:00:00.000Z",
"end": "2020-09-24T14:59:00.000Z"
},
"medicationReference": {
"reference": "#197375293",
"display": "Dopamine Hydrochloride 80 MG/ML Injection"
},
"dosage": {
"siteCodeableConcept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "66480008",
"display": "Structure of left forearm (body structure)",
"userSelected": false
}
],
"text": "Arm, Lower, Left"
},
"quantity": {
"value": 12.76,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"rateRatio": {
"numerator": {
"value": 12.76,
"unit": "milliliter (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "mL"
},
"denominator": {
"value": 1,
"unit": "hour (iso1000)",
"system": "http://unitsofmeasure.org",
"code": "h"
}
}
}
}