MedicationAdministration - FHIR Resource (r4)


This MedicationAdministration Resource uses the FHIR API standard for access and structure.

Validate an MedicationAdministration FHIR Resource (r4)



Resource Attributes

AttributeField is listTypeDescription
categoryfalseCodeableConcept# Type of medication usage
contextfalseReference# Encounter or Episode of Care administered as part of
devicetrueReference# Device used to administer
dosagefalseData Type# Details of how medication was taken
effective[x]falsedateTime|Period#undefined
eventHistorytrueReference# A list of events of interest in the lifecycle
identifiertrueIdentifier# External identifier
instantiatestrueuri# Instantiates protocol or definition
medication[x]falseReference#undefined
notetrueAnnotation# Information about the administration
partOftrueReference# Part of referenced event
performertrueData Type# Who performed the medication administration and what they did
reasonCodetrueCodeableConcept# Reason administration performed
reasonReferencetrueReference# Condition or observation that supports why the medication was administered
requestfalseReference# Request administration performed against
statusfalsecode# in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown
statusReasontrueCodeableConcept# Reason administration not performed
subjectfalseReference# Who received medication
supportingInformationtrueReference# Additional information to support administration

MedicationAdministration Example

{
  "resourceType": "MedicationAdministration",
  "id": "medadminexample03",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Generated Narrative with Details</b></p><p><b>id</b>: medadminexample03</p><p><b>contained</b>: </p><p><b>status</b>: on-hold</p><p><b>statusReason</b>: Administration of medication not done due to a contraindication (situation) <span>(Details : {SNOMED CT code '373147003' = 'Medication not administered because contraindicated', given as 'Administration of medication not done due to a contraindication (situation)'})</span></p><p><b>medication</b>: id: med0303; Alemtuzumab 10mg/ml (Lemtrada) <span>(Details : {RxNorm code '1594660' = 'alemtuzumab 10 MG/ML [Lemtrada]', given as 'Alemtuzumab 10mg/ml (Lemtrada)'})</span></p><p><b>subject</b>: <a>Donald Duck</a></p><p><b>context</b>: <a>Encounter/f001</a></p><p><b>supportingInformation</b>: <a>Condition/f204</a></p><p><b>effective</b>: 15/01/2015 2:30:00 PM --&gt; 15/01/2015 2:30:00 PM</p><p><b>request</b>: <a>MedicationRequest/medrx0317</a></p><p><b>note</b>: Patient started Bupropion this morning - will administer in a reduced dose tomorrow</p></div>"
  },
  "contained": [
    {
      "resourceType": "Medication",
      "id": "med0303",
      "code": {
        "coding": [
          {
            "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code": "1594660",
            "display": "Alemtuzumab 10mg/ml (Lemtrada)"
          }
        ]
      }
    }
  ],
  "status": "on-hold",
  "statusReason": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "373147003",
          "display": "Administration of medication not done due to a contraindication (situation)"
        }
      ]
    }
  ],
  "medicationReference": {
    "reference": "#med0303"
  },
  "subject": {
    "reference": "Patient/pat1",
    "display": "Donald Duck"
  },
  "context": {
    "reference": "Encounter/f001"
  },
  "supportingInformation": [
    {
      "reference": "Condition/f204"
    }
  ],
  "effectivePeriod": {
    "start": "2015-01-15T14:30:00+01:00",
    "end": "2015-01-15T14:30:00+01:00"
  },
  "request": {
    "reference": "MedicationRequest/medrx0317"
  },
  "note": [
    {
      "text": "Patient started Bupropion this morning - will administer in a reduced dose tomorrow"
    }
  ]
}

MedicationAdministration Structure

{
  "resourceType" : "MedicationAdministration",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External identifier
  "instantiates" : ["<uri>"], // Instantiates protocol or definition
  "partOf" : [{ Reference(MedicationAdministration|Procedure) }], // Part of referenced event
  "status" : "<code>", // R!  in-progress | not-done | on-hold | completed | entered-in-error | stopped | unknown
  "statusReason" : [{ CodeableConcept }], // Reason administration not performed
  "category" : { CodeableConcept }, // Type of medication usage
  // medication[x]: What was administered. One of these 2:
  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "subject" : { Reference(Patient|Group) }, // R!  Who received medication
  "context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter or Episode of Care administered as part of
  "supportingInformation" : [{ Reference(Any) }], // Additional information to support administration
  // effective[x]: Start and end time of administration. One of these 2:
  "effectiveDateTime" : "<dateTime>",
  "effectivePeriod" : { Period },
  "performer" : [{ // Who performed the medication administration and what they did
    "function" : { CodeableConcept }, // Type of performance
    "actor" : { Reference(Practitioner|PractitionerRole|Patient|RelatedPerson|
    Device) } // R!  Who performed the medication administration
  }],
  "reasonCode" : [{ CodeableConcept }], // Reason administration performed
  "reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport) }], // Condition or observation that supports why the medication was administered
  "request" : { Reference(MedicationRequest) }, // Request administration performed against
  "device" : [{ Reference(Device) }], // Device used to administer
  "note" : [{ Annotation }], // Information about the administration
  "dosage" : { // Details of how medication was taken
    "text" : "<string>", // Free text dosage instructions e.g. SIG
    "site" : { CodeableConcept }, // Body site administered to
    "route" : { CodeableConcept }, // Path of substance into body
    "method" : { CodeableConcept }, // How drug was administered
    "dose" : { Quantity(SimpleQuantity) }, // Amount of medication per dose
    // rate[x]: Dose quantity per unit of time. One of these 2:
    "rateRatio" : { Ratio }
    "rateQuantity" : { Quantity(SimpleQuantity) }
  },
  "eventHistory" : [{ Reference(Provenance) }] // A list of events of interest in the lifecycle
}

MedicationAdministration Search Parameters

The following search parameters can be used to query MedicationAdministration resources. Just submit them like so:

https://api.1up.health/fhir/r4/MedicationAdministration?query-param=queryvalue
Search ParameterField TypeResource Fields Searched
codetextmedication
contextreferencecontext
devicereferencedevice
effective-timedateeffective
identifiertextidentifier
medicationreferencemedication
patientreferencesubject.where
performerreferenceperformer.actor
reason-giventextreasonCode
reason-not-giventextstatusReason
requestreferencerequest
statustextstatus
subjectreferencesubject