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.

The following fields are returned if valued:

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 MedicationAdministrations that meet supplied query parameters:

GET /MedicationAdministration?:parameters

Implementation Notes

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:

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

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.