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:

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.
patient This, or _id reference The patient who has received the medication administration. Example: patient=12345
status N token The status of the medication administration, may be a list separated by commas. Example: status=active
practitioner N reference The performing clinician, may be a list separated by commas. Example: practitioner=12345
notgiven N token Administrations that were not made. A value of ‘true’ will search for these, and a value of ‘false’ will exclude them. Example: true
effectivetime N date The date/time when the administration was performed. Must use both ge and le prefixes in order to search. Example: effectivetime=ge2010-08-18&effectivetime=le2015-07-17
_count N number The maximum number of results to return.

Notes:

Headers

Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration?patient=4642007

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "a9117d85-042f-4dda-9e38-dce0286c57a4",
  "type": "searchset",
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration?patient=4642007"
    },
    {
      "relation": "next",
      "url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration?patient=4642007&-pageContext=H4sIAAAAAAAAADWMuwoCMRBF_yW1BJN1iU4nrqVWW9hJSCYmYB6Ms4KI_25AvN3hHs5bNHtDAeJ8vMxi1Ymw8An93udUDgvXEPq7UAGHVJAgJw8uWmKJz65CiIna3b4kY25XilX-RPto0tUMRptRb4fexuInnvM_qkal9M4Mm3Xf5wtjreoSiQAAAA%3D%3D&-pageDirection=NEXT"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration/7283373",
      "resource": {
        "resourceType": "MedicationAdministration",
        "id": "7283373",
        "meta": {
          "versionId": "7283374",
          "lastUpdated": "2017-11-22T17:25:12.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: Smart, Connie</p><p><b>Medication Display</b>: acetaminophen</p><p><b>Was Not Given</b>: False</p><p><b>Dosage Quantity</b>: 120</p><p><b>Medication Status</b>: in-progress</p><p><b>Effective Time</b>: 2017-11-22T17:25:00.000Z</p></div>"
        },
        "status": "in-progress",
        "patient": {
          "reference": "Patient/4642007",
          "display": "Smart, Connie"
        },
        "practitioner": {
          "reference": "Practitioner/1776007",
          "display": "Jones, Martha"
        },
        "encounter": {
          "reference": "Encounter/4251906"
        },
        "prescription": {
          "reference": "MedicationOrder/22954085"
        },
        "wasNotGiven": false,
        "effectiveTimeDateTime": "2017-11-22T17:25:00.000Z",
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "161",
              "display": "Acetaminophen",
              "userSelected": false
            }
          ],
          "text": "acetaminophen"
        },
        "dosage": {
          "text": "120 mg Oral q4hr",
          "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": 120,
            "unit": "mg",
            "system": "http://unitsofmeasure.org"
          }
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration/7283283",
      "resource": {
        "resourceType": "MedicationAdministration",
        "id": "7283283",
        "meta": {
          "versionId": "7283294",
          "lastUpdated": "2017-11-22T16:10:18.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: Smart, Connie</p><p><b>Medication Display</b>: Sodium Chloride 0.154 MEQ/ML Injectable Solution</p><p><b>Was Not Given</b>: False</p><p><b>Dosage Quantity</b>: 100</p><p><b>Medication Status</b>: in-progress</p><p><b>Effective Time</b>: 2017-11-22T16:09:00.000Z</p></div>"
        },
        "contained": [
          {
            "resourceType": "Medication",
            "id": "7283283",
            "product": {
              "ingredient": [
                {
                  "item": {
                    "reference": "#7283285-1",
                    "display": "Sodium Chloride 0.154 MEQ/ML Injectable Solution"
                  },
                  "amount": {
                    "numerator": {
                      "value": 100,
                      "unit": "mL",
                      "system": "http://unitsofmeasure.org"
                    }
                  }
                },
                {
                  "item": {
                    "reference": "#7283287-2",
                    "display": "Glucose 50 MG/ML Injectable Solution"
                  },
                  "amount": {
                    "numerator": {
                      "value": 25,
                      "unit": "mL",
                      "system": "http://unitsofmeasure.org"
                    }
                  }
                }
              ]
            }
          },
          {
            "resourceType": "Medication",
            "id": "7283285-1",
            "code": {
              "coding": [
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "313002",
                  "display": "Sodium Chloride 0.154 MEQ/ML Injectable Solution",
                  "userSelected": false
                }
              ],
              "text": "Sodium Chloride 0.9%"
            }
          },
          {
            "resourceType": "Medication",
            "id": "7283287-2",
            "code": {
              "coding": [
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "309778",
                  "display": "Glucose 50 MG/ML Injectable Solution",
                  "userSelected": false
                }
              ],
              "text": "Dextrose 5% in Water"
            }
          }
        ],
        "status": "in-progress",
        "patient": {
          "reference": "Patient/4642007",
          "display": "Smart, Connie"
        },
        "practitioner": {
          "reference": "Practitioner/1776007",
          "display": "Jones, Martha"
        },
        "encounter": {
          "reference": "Encounter/4251906"
        },
        "prescription": {
          "reference": "MedicationOrder/22961893"
        },
        "wasNotGiven": false,
        "effectiveTimeDateTime": "2017-11-22T16:09:00.000Z",
        "medicationReference": {
          "reference": "#7283283",
          "display": "Sodium Chloride 0.154 MEQ/ML Injectable Solution"
        },
        "note": "PRODUCT NOTE\nADMIN NOTE\nOrder coment\n2017-11-22T16:10:18.000Z - 1776007",
        "dosage": {
          "text": "IV Piggyback BID",
          "siteCodeableConcept": {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "368208006",
                "display": "left upper arm structure (body structure)",
                "userSelected": false
              }
            ],
            "text": "Left Upper Arm"
          },
          "route": {
            "coding": [
              {
                "system": "http://ncimeta.nci.nih.gov",
                "code": "C38279",
                "display": "INTRAVENOUS DRIP",
                "userSelected": false
              },
              {
                "system": "http://snomed.info/sct",
                "code": "47625008",
                "display": "Intravenous route (qualifier value)",
                "userSelected": false
              }
            ],
            "text": "IV Piggyback"
          },
          "quantity": {
            "value": 100,
            "unit": "mL",
            "system": "http://unitsofmeasure.org"
          }
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration/7277367",
      "resource": {
        "resourceType": "MedicationAdministration",
        "id": "7277367",
        "meta": {
          "versionId": "7277366",
          "lastUpdated": "2017-11-21T22:26:04.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: Smart, Connie</p><p><b>Medication Display</b>: Dextrose 2.5% with 0.45% NaCl</p><p><b>Was Not Given</b>: False</p><p><b>Dosage Quantity</b>: 100</p><p><b>Dosage Rate</b>: 125</p><p><b>Medication Status</b>: in-progress</p><p><b>Effective Start Time</b>: 2017-11-21T22:40:00.000Z</p><p><b>Effective End Time</b>: 2017-11-21T23:00:00.000Z</p></div>"
        },
        "status": "in-progress",
        "patient": {
          "reference": "Patient/4642007",
          "display": "Smart, Connie"
        },
        "practitioner": {
          "reference": "Practitioner/1776007",
          "display": "Jones, Martha"
        },
        "encounter": {
          "reference": "Encounter/4251906"
        },
        "prescription": {
          "reference": "MedicationOrder/22954301"
        },
        "wasNotGiven": false,
        "effectiveTimePeriod": {
          "start": "2017-11-21T22:40:00.000Z",
          "end": "2017-11-21T23:00:00.000Z"
        },
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "244095",
              "display": "Glucose 25 MG/ML / Sodium Chloride 0.0769 MEQ/ML Injectable Solution",
              "userSelected": false
            }
          ],
          "text": "Dextrose 2.5% with 0.45% NaCl"
        },
        "dosage": {
          "text": "1000 mL IV at 125 mL/hr",
          "siteCodeableConcept": {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "78791008",
                "display": "structure of right hand (body structure)",
                "userSelected": false
              }
            ],
            "text": "Right Hand"
          },
          "quantity": {
            "value": 100,
            "unit": "mL",
            "system": "http://unitsofmeasure.org"
          },
          "rateRatio": {
            "numerator": {
              "value": 125,
              "unit": "mL",
              "system": "http://unitsofmeasure.org"
            },
            "denominator": {
              "value": 1,
              "unit": "h",
              "system": "http://unitsofmeasure.org"
            }
          }
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration/7277321",
      "resource": {
        "resourceType": "MedicationAdministration",
        "id": "7277321",
        "meta": {
          "versionId": "7277322",
          "lastUpdated": "2017-11-21T21:56:15.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: Smart, Connie</p><p><b>Medication Display</b>: acetaminophen</p><p><b>Was Not Given</b>: True</p><p><b>Medication Status</b>: stopped</p><p><b>Effective Time</b>: 2017-11-21T21:56:00.000Z</p></div>"
        },
        "status": "stopped",
        "patient": {
          "reference": "Patient/4642007",
          "display": "Smart, Connie"
        },
        "practitioner": {
          "reference": "Practitioner/1776007",
          "display": "Jones, Martha"
        },
        "encounter": {
          "reference": "Encounter/4251906"
        },
        "prescription": {
          "reference": "MedicationOrder/22954085"
        },
        "wasNotGiven": true,
        "reasonNotGiven": [
          {
            "coding": [
              {
                "code": "2593",
                "display": "Not Done: Patient Sleeping",
                "userSelected": true
              }
            ],
            "text": "Not Done: Patient Sleeping"
          }
        ],
        "effectiveTimeDateTime": "2017-11-21T21:56:00.000Z",
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "161",
              "display": "Acetaminophen",
              "userSelected": false
            }
          ],
          "text": "acetaminophen"
        },
        "note": "2017-11-21T21:56:14.000Z - 1776007 - Result comment entered for acetaminophen - Chart Not Done workflow\n"
      }
    }
  ]
}

Errors

The common errors 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.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationAdministration/7283373

Response

Status: 200 OK
{
  "resourceType": "MedicationAdministration",
  "id": "7283373",
  "meta": {
    "versionId": "7283374",
    "lastUpdated": "2017-11-22T17:25:12.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div><p><b>Medication Administration</b></p><p><b>Patient Name</b>: Smart, Connie</p><p><b>Medication Display</b>: acetaminophen</p><p><b>Was Not Given</b>: False</p><p><b>Dosage Quantity</b>: 120</p><p><b>Medication Status</b>: in-progress</p><p><b>Effective Time</b>: 2017-11-22T17:25:00.000Z</p></div>"
  },
  "status": "in-progress",
  "patient": {
    "reference": "Patient/4642007",
    "display": "Smart, Connie"
  },
  "practitioner": {
    "reference": "Practitioner/1776007",
    "display": "Jones, Martha"
  },
  "encounter": {
    "reference": "Encounter/4251906"
  },
  "prescription": {
    "reference": "MedicationOrder/22954085"
  },
  "wasNotGiven": false,
  "effectiveTimeDateTime": "2017-11-22T17:25:00.000Z",
  "medicationCodeableConcept": {
    "coding": [
      {
        "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
        "code": "161",
        "display": "Acetaminophen",
        "userSelected": false
      }
    ],
    "text": "acetaminophen"
  },
  "dosage": {
    "text": "120 mg Oral q4hr",
    "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": 120,
      "unit": "mg",
      "system": "http://unitsofmeasure.org"
    }
  }
}

Errors

The common errors may be returned.