MedicationStatement - FHIR Resource (r4)


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

Validate an MedicationStatement FHIR Resource (r4)



Resource Attributes

AttributeField is listTypeDescription
basedOntrueReference# Fulfils plan, proposal or order
categoryfalseCodeableConcept# Type of medication usage
contextfalseReference# Encounter / Episode associated with MedicationStatement
dateAssertedfalsedateTime# When the statement was asserted?
derivedFromtrueReference# Additional supporting information
dosagetrueDosage# Details of how medication is/was taken or should be taken
effective[x]falsedateTime|Period#undefined
identifiertrueIdentifier# External identifier
informationSourcefalseReference# "informationSource" : { Reference(Patient|Practitioner|PractitionerRole|
medication[x]falseReference#undefined
notetrueAnnotation# Further information about the statement
partOftrueReference# "partOf" : [{ Reference(MedicationAdministration|MedicationDispense|
reasonCodetrueCodeableConcept# Reason for why the medication is being/was taken
reasonReferencetrueReference# Condition or observation that supports why the medication is being/was taken
statusfalsecode# active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
statusReasontrueCodeableConcept# Reason for current status
subjectfalseReference# Who is/was taking the medication

MedicationStatement Example

{
  "resourceType": "MedicationStatement",
  "id": "example001",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Generated Narrative with Details</b></p><p><b>id</b>: example001</p><p><b>contained</b>: </p><p><b>identifier</b>: 12345689 (OFFICIAL)</p><p><b>status</b>: active</p><p><b>category</b>: Inpatient <span>(Details : {http://terminology.hl7.org/CodeSystem/medication-statement-category code 'inpatient' = 'Inpatient', given as 'Inpatient'})</span></p><p><b>medication</b>: id: med0309; Tylenol PM <span>(Details : {http://hl7.org/fhir/sid/ndc code '50580-506-02' = 'n/a', given as 'Tylenol PM'})</span>; Film-coated tablet (qualifier value) <span>(Details : {SNOMED CT code '385057009' = 'Film-coated tablet', given as 'Film-coated tablet (qualifier value)'})</span></p><p><b>subject</b>: <a>Donald Duck</a></p><p><b>effective</b>: 23/01/2015</p><p><b>dateAsserted</b>: 22/02/2015</p><p><b>informationSource</b>: <a>Donald Duck</a></p><p><b>derivedFrom</b>: <a>MedicationRequest/medrx002</a></p><p><b>reasonCode</b>: Restless Legs <span>(Details : {SNOMED CT code '32914008' = 'Restless legs', given as 'Restless Legs'})</span></p><p><b>note</b>: Patient indicates they miss the occasional dose</p><p><b>dosage</b>: </p></div>"
  },
  "contained": [
    {
      "resourceType": "Medication",
      "id": "med0309",
      "code": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/sid/ndc",
            "code": "50580-506-02",
            "display": "Tylenol PM"
          }
        ]
      },
      "form": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "385057009",
            "display": "Film-coated tablet (qualifier value)"
          }
        ]
      },
      "ingredient": [
        {
          "itemCodeableConcept": {
            "coding": [
              {
                "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                "code": "315266",
                "display": "Acetaminophen 500 MG"
              }
            ]
          },
          "strength": {
            "numerator": {
              "value": 500,
              "system": "http://unitsofmeasure.org",
              "code": "mg"
            },
            "denominator": {
              "value": 1,
              "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm",
              "code": "Tab"
            }
          }
        },
        {
          "itemCodeableConcept": {
            "coding": [
              {
                "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                "code": "901813",
                "display": "Diphenhydramine Hydrochloride 25 mg"
              }
            ]
          },
          "strength": {
            "numerator": {
              "value": 25,
              "system": "http://unitsofmeasure.org",
              "code": "mg"
            },
            "denominator": {
              "value": 1,
              "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm",
              "code": "Tab"
            }
          }
        }
      ],
      "batch": {
        "lotNumber": "9494788",
        "expirationDate": "2017-05-22"
      }
    }
  ],
  "identifier": [
    {
      "use": "official",
      "system": "http://www.bmc.nl/portal/medstatements",
      "value": "12345689"
    }
  ],
  "status": "active",
  "category": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/medication-statement-category",
        "code": "inpatient",
        "display": "Inpatient"
      }
    ]
  },
  "medicationReference": {
    "reference": "#med0309"
  },
  "subject": {
    "reference": "Patient/pat1",
    "display": "Donald Duck"
  },
  "effectiveDateTime": "2015-01-23",
  "dateAsserted": "2015-02-22",
  "informationSource": {
    "reference": "Patient/pat1",
    "display": "Donald Duck"
  },
  "derivedFrom": [
    {
      "reference": "MedicationRequest/medrx002"
    }
  ],
  "reasonCode": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "32914008",
          "display": "Restless Legs"
        }
      ]
    }
  ],
  "note": [
    {
      "text": "Patient indicates they miss the occasional dose"
    }
  ],
  "dosage": [
    {
      "sequence": 1,
      "text": "1-2 tablets once daily at bedtime as needed for restless legs",
      "additionalInstruction": [
        {
          "text": "Taking at bedtime"
        }
      ],
      "timing": {
        "repeat": {
          "frequency": 1,
          "period": 1,
          "periodUnit": "d"
        }
      },
      "asNeededCodeableConcept": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "32914008",
            "display": "Restless Legs"
          }
        ]
      },
      "route": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "26643006",
            "display": "Oral Route"
          }
        ]
      },
      "doseAndRate": [
        {
          "type": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/dose-rate-type",
                "code": "ordered",
                "display": "Ordered"
              }
            ]
          },
          "doseRange": {
            "low": {
              "value": 1,
              "unit": "TAB",
              "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm",
              "code": "TAB"
            },
            "high": {
              "value": 2,
              "unit": "TAB",
              "system": "http://terminology.hl7.org/CodeSystem/v3-orderableDrugForm",
              "code": "TAB"
            }
          }
        }
      ]
    }
  ]
}

MedicationStatement Structure

{
  "resourceType" : "MedicationStatement",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External identifier
  "basedOn" : [{ Reference(MedicationRequest|CarePlan|ServiceRequest) }], // Fulfils plan, proposal or order
  "partOf" : [{ Reference(MedicationAdministration|MedicationDispense|
   MedicationStatement|Procedure|Observation) }], // Part of referenced event
  "status" : "<code>", // R!  active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
  "statusReason" : [{ CodeableConcept }], // Reason for current status
  "category" : { CodeableConcept }, // Type of medication usage
  // medication[x]: What medication was taken. One of these 2:
  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "subject" : { Reference(Patient|Group) }, // R!  Who is/was taking  the medication
  "context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter / Episode associated with MedicationStatement
  // effective[x]: The date/time or interval when the medication is/was/will be taken. One of these 2:
  "effectiveDateTime" : "<dateTime>",
  "effectivePeriod" : { Period },
  "dateAsserted" : "<dateTime>", // When the statement was asserted?
  "informationSource" : { Reference(Patient|Practitioner|PractitionerRole|
   RelatedPerson|Organization) }, // Person or organization that provided the information about the taking of this medication
  "derivedFrom" : [{ Reference(Any) }], // Additional supporting information
  "reasonCode" : [{ CodeableConcept }], // Reason for why the medication is being/was taken
  "reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport) }], // Condition or observation that supports why the medication is being/was taken
  "note" : [{ Annotation }], // Further information about the statement
  "dosage" : [{ Dosage }] // Details of how medication is/was taken or should be taken
}

MedicationStatement Search Parameters

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

https://api.1up.health/fhir/r4/MedicationStatement?query-param=queryvalue
Search ParameterField TypeResource Fields Searched
categorytextcategory
codetextmedication
contextreferencecontext
effectivedateeffective
identifiertextidentifier
medicationreferencemedication
part-ofreferencepartOf
patientreferencesubject.where
sourcereferenceinformationSource
statustextstatus
subjectreferencesubject