MedicationStatement - FHIR Resource (r4)
This MedicationStatement Resource uses the FHIR API standard for access and structure.
Validate an MedicationStatement FHIR Resource (r4)
MedicationStatement Attributes
AttributeField is listTypeDescription
Description: External identifier
FHIR Version: r4
Attribute Type : Identifier
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"identifier": [
{
"use": "official",
"system": "http://www.bmc.nl/portal/medstatements",
"value": "12345689"
}
]Learn more about the (MedicationStatement) identifier FHIR attribute
Description: Fulfils plan, proposal or order
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"basedOn": Learn more about the (MedicationStatement) basedOn FHIR attribute
Description: "partOf" : [{ Reference(MedicationAdministration|MedicationDispense|
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"partOf": Learn more about the (MedicationStatement) partOf FHIR attribute
Description: active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
FHIR Version: r4
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"status": "active"Learn more about the (MedicationStatement) status FHIR attribute
Description: Reason for current status
FHIR Version: r4
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"statusReason": Learn more about the (MedicationStatement) statusReason FHIR attribute
Description: Type of medication usage
FHIR Version: r4
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"category": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/medication-statement-category",
"code": "inpatient",
"display": "Inpatient"
}
]
}Learn more about the (MedicationStatement) category FHIR attribute
Description:
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"medication[x]": Learn more about the (MedicationStatement) medication[x] FHIR attribute
Description: Who is/was taking the medication
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"subject": {
"reference": "Patient/pat1",
"display": "Donald Duck"
}Learn more about the (MedicationStatement) subject FHIR attribute
Description: Encounter / Episode associated with MedicationStatement
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"context": Learn more about the (MedicationStatement) context FHIR attribute
Description:
FHIR Version: r4
Attribute Type : dateTime|Period
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"effective[x]": Learn more about the (MedicationStatement) effective[x] FHIR attribute
Description: When the statement was asserted?
FHIR Version: r4
Attribute Type : dateTime
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"dateAsserted": "2015-02-22"Learn more about the (MedicationStatement) dateAsserted FHIR attribute
Description: "informationSource" : { Reference(Patient|Practitioner|PractitionerRole|
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"informationSource": {
"reference": "Patient/pat1",
"display": "Donald Duck"
}Learn more about the (MedicationStatement) informationSource FHIR attribute
Description: Additional supporting information
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"derivedFrom": [
{
"reference": "MedicationRequest/medrx002"
}
]Learn more about the (MedicationStatement) derivedFrom FHIR attribute
Description: Reason for why the medication is being/was taken
FHIR Version: r4
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"reasonCode": [
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "32914008",
"display": "Restless Legs"
}
]
}
]Learn more about the (MedicationStatement) reasonCode FHIR attribute
Description: Condition or observation that supports why the medication is being/was taken
FHIR Version: r4
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"reasonReference": Learn more about the (MedicationStatement) reasonReference FHIR attribute
Description: Further information about the statement
FHIR Version: r4
Attribute Type : Annotation
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"note": [
{
"text": "Patient indicates they miss the occasional dose"
}
]Learn more about the (MedicationStatement) note FHIR attribute
Description: Details of how medication is/was taken or should be taken
FHIR Version: r4
Attribute Type : Dosage
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:
"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"
}
}
}
]
}
]Learn more about the (MedicationStatement) dosage FHIR attribute
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 Parameter | Field Type | Resource Fields Searched |
|---|---|---|
category | text | category |
code | text | medication |
context | reference | context |
effective | date | effective |
identifier | text | identifier |
medication | reference | medication |
part-of | reference | partOf |
patient | reference | subject.where |
source | reference | informationSource |
status | text | status |
subject | reference | subject |
