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.

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.status
  • Description
    • The medication administration status.
  • Details: MedicationAdministration Status
    System: http://terminology.hl7.org/CodeSystem/medication-admin-status

MedicationAdministration.statusReason
MedicationAdministration.medicationCodeableConcept
  • Description
    • A code that defines the medication that was administered.
  • Details: RxNorm
    System: http://www.nlm.nih.gov/research/umls/rxnorm

MedicationAdministration.performer.function
MedicationAdministration.dosage.site
  • Description
    • A coded specification of the anatomic site where the medication first entered the body.
  • Details: SNOMED CT
    System: http://snomed.info/sct

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

Contained Medication Bindings

Medication.code
  • Description
    • A code that defines the 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/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 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

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