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.

The following fields are returned if valued:

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
  • Description
    • A code that defines the type of medication.
  • Details: RxNorm
    System: http://www.nlm.nih.gov/research/umls/rxnorm

MedicationAdministration.dosage.siteCodeableConcept
  • Description
    • The anatomic site where the medication first enters the body.
  • Details: SNOMED CT
    System: http://snomed.info/sct

MedicationAdministration.dosage.route
  • Description
    • A code specifying the route or physiological path of administration of a therapeutic agent into or onto a subject.
  • Details: SNOMED CT
    System: http://snomed.info/sct

  • Details: NCI Metathesaurus
    System: http://ncimeta.nci.nih.gov

Contained Medication Bindings

Medication.code
  • Description
    • A code that defines the type of medication.
  • Details: RxNorm
    System: http://www.nlm.nih.gov/research/umls/rxnorm

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 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

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"
      }
    }
  }
}