MedicationStatement

Overview

The Medication Statement resource provides a snapshot in time of known medications taken by the patient now or in the past reported by either the patient, significant other or a provider. Future orders are not returned. Documented historical/past/home medications are commonly captured when taking the patient’s medical history. Prescriptions without documented compliance are Intended, since we may not know if the patient is actively taking the medication or has filled the prescription. Medications are assumed to be Taken unless documented otherwise.

References to implicitRules and modifierExtensions are NOT supported and will fail a Create or Update request.

The following fields are returned if valued:

Querying for Active Medications

To get all possible current medications, an application should query MedicationStatement with the status query parameter set to active,intended. Since MedicationStatement is a snapshot in time, this is only a representation of what the system knew of during the last contact with the patient, and will not include things that have happened since the patient last visited with their provider.

To get the list of current medications that would likely be shown by default to a practitioner, the MedicationOrder resource should be used in addition to the query above in order to ensure that draft orders are included. Duplicates can be removed using the MedicationStatement.supportingInformation reference. A duplicate is identified when MedicationOrder.id is equivalent to the supportingInformation referenced MedicationOrder/[id]

Terminology Bindings

MedicationStatement.reasonForUse[x]
MedicationStatement.medication[x]
  • Description
    • A code that defines the type of medication.
  • RxNorm
MedicationStatement.dosage.timing.code
MedicationStatement.dosage.asNeeded[x]
  • Description
    • A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose.
  • SNOMED CT
MedicationStatement.dosage.siteCodeableConcept
  • Description
    • Where on the body the medication is/was administered.
  • SNOMED CT
MedicationStatement.dosage.route
  • Description
    • A coded concept describing the 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

  • Details: NCI Metathesaurus
    System: http://ncimeta.nci.nih.gov

Contained Medication Bindings

Medication.code
  • Description
    • A code that defines the type of medication.
  • Details: RxNorm
    System: http://www.nlm.nih.gov/research/umls/rxnorm

Medication.product.form
  • Description
    • Describes the form of the item.
  • Details: NCI Metathesaurus
    System: http://ncimeta.nci.nih.gov

Contained Practitioner Bindings

Practitioner.practitionerRole.role
  • Description
    • The roles which this practitioner is authorized to perform for the organization.
  • Practitioner Role

Extensions

Custom Extensions

All URLs for custom extensions are defined as https://fhir-ehr.cerner.com/dstu2/StructureDefinition/{id}

ID Value[x] Type Description
patient-friendly-display string The display that can be used for this field when producing a view suitable for a patient.
medication-statement-category CodeableConcept The category of the order, for example: patientspecified, outpatient, etc.

Search for MedicationStatements that meet supplied query parameters:

GET /MedicationStatement?: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 identifier of a patient to list statements for. Example: 12345
status N token The status of the medication statement, may be a list separated by commas. Example: active,completed
_count N number The maximum number of results to return. Defaults to 50.

Notes:

Headers

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

Example

Request

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

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "7aa4c6ad-fa0c-4169-83d2-49dd3a2dde28",
  "type": "searchset",
  "total": 4,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement?patient=4342010&_count=50"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/21389901",
      "resource": {
        "resourceType": "MedicationStatement",
        "id": "21389901",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2016-06-27T15:00:00.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Statement</b></p><p><b>Patient Name</b>: Smart, Joe</p><p><b>Medication Name</b>: acebutolol (Sectral)</p><p><b>Dosage Instructions</b>: 200 mg, 1 caps, Oral, Daily</p><p><b>Status</b>: Active</p><p><b>Taken</b>: Yes</p></div>"
        },
        "extension": [
          {
            "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/medication-statement-category",
            "valueCodeableConcept": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/medication-statement-category",
                  "code": "inpatient",
                  "display": "Inpatient"
                }
              ],
              "text": "Inpatient"
            }
          }
        ],
        "patient": {
          "reference": "Patient/4342010",
          "display": "Smart, Joe"
        },
        "informationSource": {
          "reference": "Practitioner/1912007",
          "display": "Who, Doctor"
        },
        "dateAsserted": "2016-06-27T09:57:32.000-05:00",
        "status": "active",
        "wasNotTaken": false,
        "effectivePeriod": {
          "start": "2016-06-27T09:00:00.000-07:00"
        },
        "supportingInformation": [
          {
            "reference": "MedicationOrder/21389901"
          }
        ],
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "9631",
              "display": "Sectral",
              "userSelected": false
            }
          ],
          "text": "acebutolol (Sectral)"
        },
        "dosage": [
          {
            "text": "200 mg, 1 caps, Oral, Daily",
            "_text": {
              "extension": [
                {
                  "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display",
                  "valueString": "200 Milligram Oral every day. Refills: 0."
                }
              ]
            },
            "timing": {
              "repeat": {
                "boundsPeriod": {
                  "start": "2016-06-27T09:00:00.000-07:00"
                }
              },
              "code": {
                "coding": [
                  {
                    "system": "http://hl7.org/fhir/timing-abbreviation",
                    "code": "QD",
                    "display": "QD",
                    "userSelected": false
                  }
                ],
                "text": "Daily"
              }
            },
            "route": {
              "coding": [
                {
                  "system": "http://ncimeta.nci.nih.gov",
                  "code": "C38288",
                  "display": "ORAL",
                  "userSelected": false
                }
              ],
              "text": "Oral"
            },
            "quantityQuantity": {
              "value": 200.0,
              "unit": "mg",
              "system": "http://unitsofmeasure.org",
              "code": "mg"
            }
          }
        ]
      }
    },
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/21389899",
      "resource": {
        "resourceType": "MedicationStatement",
        "id": "21389899",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2016-06-27T14:59:58.000Z"
        },
        "extension": [
          {
            "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/medication-statement-category",
            "valueCodeableConcept": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/medication-statement-category",
                  "code": "inpatient",
                  "display": "Inpatient"
                }
              ],
              "text": "Inpatient"
            }
          }
        ],
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Statement</b></p><p><b>Patient Name</b>: Smart, Joe</p><p><b>Medication Name</b>: furosemide (Lasix)</p><p><b>Dosage Instructions</b>: 80 mg, 1 tabs, Oral, Daily</p><p><b>Status</b>: Active</p><p><b>Taken</b>: Yes</p></div>"
        },
        "patient": {
          "reference": "Patient/4342010",
          "display": "Smart, Joe"
        },
        "informationSource": {
          "reference": "Practitioner/1912007",
          "display": "Who, Doctor"
        },
        "dateAsserted": "2016-06-27T09:56:37.000-05:00",
        "status": "active",
        "wasNotTaken": false,
        "effectivePeriod": {
          "start": "2016-06-27T09:00:00.000-07:00"
        },
        "supportingInformation": [
          {
            "reference": "MedicationOrder/21389899"
          }
        ],
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "202991",
              "display": "Lasix",
              "userSelected": false
            }
          ],
          "text": "furosemide (Lasix)"
        },
        "dosage": [
          {
            "text": "80 mg, 1 tabs, Oral, Daily",
            "_text": {
              "extension": [
                {
                  "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display",
                  "valueString": "80 Milligram Oral every day. Refills: 0."
                }
              ]
            },
            "timing": {
              "repeat": {
                "boundsPeriod": {
                  "start": "2016-06-27T09:00:00.000-07:00"
                }
              },
              "code": {
                "coding": [
                  {
                    "system": "http://hl7.org/fhir/timing-abbreviation",
                    "code": "QD",
                    "display": "QD",
                    "userSelected": false
                  }
                ],
                "text": "Daily"
              }
            },
            "route": {
              "coding": [
                {
                  "system": "http://ncimeta.nci.nih.gov",
                  "code": "C38288",
                  "display": "ORAL",
                  "userSelected": false
                }
              ],
              "text": "Oral"
            },
            "quantityQuantity": {
              "value": 80.0,
              "unit": "mg",
              "system": "http://unitsofmeasure.org",
              "code": "mg"
            }
          }
        ]
      }
    },
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/22298109",
      "resource": {
        "resourceType": "MedicationStatement",
        "id": "22298109",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2017-02-09T16:31:47.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Statement</b></p><p><b>Patient Name</b>: Smart, Joe</p><p><b>Medication Name</b>: vancomycin</p><p><b>Dosage Instructions</b>: 1 g, IV, q12hr</p><p><b>Status</b>: Active</p><p><b>Taken</b>: Yes</p></div>"
        },
        "extension": [
          {
            "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/medication-statement-category",
            "valueCodeableConcept": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/medication-statement-category",
                  "code": "inpatient",
                  "display": "Inpatient"
                }
              ],
              "text": "Inpatient"
            }
          }
        ],
        "patient": {
          "reference": "Patient/4342010",
          "display": "Smart, Joe"
        },
        "informationSource": {
          "reference": "Practitioner/4474007",
          "display": "Song, River"
        },
        "dateAsserted": "2017-02-09T10:31:00.000-06:00",
        "status": "active",
        "wasNotTaken": false,
        "effectivePeriod": {
          "start": "2017-02-09T09:00:00.000-08:00"
        },
        "supportingInformation": [
          {
            "reference": "MedicationOrder/22298109"
          }
        ],
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "11124",
              "display": "Vancomycin",
              "userSelected": false
            }
          ],
          "text": "vancomycin"
        },
        "dosage": [
          {
            "text": "1 g, IV, q12hr",
            "_text": {
              "extension": [
                {
                  "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display",
                  "valueString": "1 Gram Intravenous every 12 hours. Refills: 0."
                }
              ]
            },
            "timing": {
              "repeat": {
                "boundsPeriod": {
                  "start": "2017-02-09T09:00:00.000-08:00"
                }
              },
              "code": {
                "text": "q12hr"
              }
            },
            "route": {
              "coding": [
                {
                  "system": "http://ncimeta.nci.nih.gov",
                  "code": "C38276",
                  "display": "INTRAVENOUS",
                  "userSelected": false
                }
              ],
              "text": "IV"
            },
            "quantityQuantity": {
              "value": 1.0,
              "unit": "g",
              "system": "http://unitsofmeasure.org",
              "code": "g"
            }
          }
        ]
      }
    },
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/22298077",
      "resource": {
        "resourceType": "MedicationStatement",
        "id": "22298077",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2017-02-09T16:30:45.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div><p><b>Medication Statement</b></p><p><b>Patient Name</b>: Smart, Joe</p><p><b>Medication Name</b>: vancomycin + Dextrose 5% in Water 100 mL</p><p><b>Dosage Instructions</b>: 100 mg, IV, q12hr</p><p><b>Status</b>: Entered in Error</p></div>"
        },
        "contained": [
          {
            "resourceType": "Medication",
            "id": "2770945",
            "code": {
              "text": "vancomycin + Dextrose 5% in Water 100 mL"
            },
            "product": {
              "ingredient": [
                {
                  "item": {
                    "reference": "#2770945-1",
                    "display": "vancomycin"
                  },
                  "amount": {
                    "numerator": {
                      "value": 100.0,
                      "unit": "mg",
                      "system": "http://unitsofmeasure.org",
                      "code": "mg"
                    },
                    "denominator": {
                      "value": 100.0,
                      "unit": "mL",
                      "system": "http://unitsofmeasure.org",
                      "code": "mL"
                    }
                  }
                },
                {
                  "item": {
                    "reference": "#2778758-2",
                    "display": "Dextrose 5% in Water"
                  },
                  "amount": {
                    "numerator": {
                      "value": 100.0,
                      "unit": "mL",
                      "system": "http://unitsofmeasure.org",
                      "code": "mL"
                    },
                    "denominator": {
                      "value": 100.0,
                      "unit": "mL",
                      "system": "http://unitsofmeasure.org",
                      "code": "mL"
                    }
                  }
                }
              ]
            }
          },
          {
            "resourceType": "Medication",
            "id": "2770945-1",
            "code": {
              "coding": [
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "11124",
                  "display": "Vancomycin",
                  "userSelected": false
                }
              ],
              "text": "vancomycin"
            }
          },
          {
            "resourceType": "Medication",
            "id": "2778758-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"
            }
          }
        ],
        "extension": [
          {
            "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/medication-statement-category",
            "valueCodeableConcept": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/medication-statement-category",
                  "code": "inpatient",
                  "display": "Inpatient"
                }
              ],
              "text": "Inpatient"
            }
          }
        ],
        "patient": {
          "reference": "Patient/4342010",
          "display": "Smart, Joe"
        },
        "informationSource": {
          "reference": "Practitioner/4474007",
          "display": "Song, River"
        },
        "dateAsserted": "2017-02-09T09:29:09.000-06:00",
        "status": "entered-in-error",
        "effectivePeriod": {
          "start": "2017-02-09T08:00:00.000-08:00",
          "end": "2017-02-09T08:30:45.000-08:00"
        },
        "supportingInformation": [
          {
            "reference": "MedicationOrder/22298077"
          }
        ],
        "medicationReference": {
          "reference": "#2770945",
          "display": "vancomycin + Dextrose 5% in Water 100 mL"
        },
        "dosage": [
          {
            "text": "100 mg, IV, q12hr",
            "_text": {
              "extension": [
                {
                  "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display",
                  "valueString": "Intravenous every 12 hours for 6 Days. Refills: 0."
                }
              ]
            },
            "timing": {
              "repeat": {
                "boundsQuantity": {
                  "value": 6,
                  "unit": "days",
                  "system": "http://unitsofmeasure.org",
                  "code": "d"
                }
              },
              "code": {
                "text": "q12hr"
              }
            },
            "route": {
              "coding": [
                {
                  "system": "http://ncimeta.nci.nih.gov",
                  "code": "C38276",
                  "display": "INTRAVENOUS",
                  "userSelected": false
                }
              ],
              "text": "IV"
            },
            "quantityQuantity": {
              "value": 100.0,
              "unit": "mL",
              "system": "http://unitsofmeasure.org",
              "code": "mL"
            }
          }
        ]
      }
    }
  ]
}

Errors

The common errors may be returned.

Retrieve by id

List an individual MedicationStatement by its id:

GET /MedicationStatement/: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/MedicationStatement/22298077

Response

Status: 200 OK
{
  "resourceType": "MedicationStatement",
  "id": "22298077",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2017-02-09T16:30:45.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div><p><b>Medication Statement</b></p><p><b>Patient Name</b>: Smart, Joe</p><p><b>Medication Name</b>: vancomycin + Dextrose 5% in Water 100 mL</p><p><b>Dosage Instructions</b>: 100 mg, IV, q12hr</p><p><b>Status</b>: Entered in Error</p></div>"
  },
  "contained": [
    {
      "resourceType": "Medication",
      "id": "2770945",
      "code": {
        "text": "vancomycin + Dextrose 5% in Water 100 mL"
      },
      "product": {
        "ingredient": [
          {
            "item": {
              "reference": "#2770945-1",
              "display": "vancomycin"
            },
            "amount": {
              "numerator": {
                "value": 100.0,
                "unit": "mg",
                "system": "http://unitsofmeasure.org",
                "code": "mg"
              },
              "denominator": {
                "value": 100.0,
                "unit": "mL",
                "system": "http://unitsofmeasure.org",
                "code": "mL"
              }
            }
          },
          {
            "item": {
              "reference": "#2778758-2",
              "display": "Dextrose 5% in Water"
            },
            "amount": {
              "numerator": {
                "value": 100.0,
                "unit": "mL",
                "system": "http://unitsofmeasure.org",
                "code": "mL"
              },
              "denominator": {
                "value": 100.0,
                "unit": "mL",
                "system": "http://unitsofmeasure.org",
                "code": "mL"
              }
            }
          }
        ]
      }
    },
    {
      "resourceType": "Medication",
      "id": "2770945-1",
      "code": {
        "coding": [
          {
            "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code": "11124",
            "display": "Vancomycin",
            "userSelected": false
          }
        ],
        "text": "vancomycin"
      }
    },
    {
      "resourceType": "Medication",
      "id": "2778758-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"
      }
    }
  ],
  "extension": [
    {
      "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/medication-statement-category",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/medication-statement-category",
            "code": "inpatient",
            "display": "Inpatient"
          }
        ],
        "text": "Inpatient"
      }
    }
  ],
  "patient": {
    "reference": "Patient/4342010",
    "display": "Smart, Joe"
  },
  "informationSource": {
    "reference": "Practitioner/4474007",
    "display": "Song, River"
  },
  "dateAsserted": "2017-02-09T09:29:09.000-06:00",
  "status": "entered-in-error",
  "effectivePeriod": {
    "start": "2017-02-09T08:00:00.000-08:00",
    "end": "2017-02-09T08:30:45.000-08:00"
  },
  "supportingInformation": [
    {
      "reference": "MedicationOrder/22298077"
    }
  ],
  "medicationReference": {
    "reference": "#2770945",
    "display": "vancomycin + Dextrose 5% in Water 100 mL"
  },
  "dosage": [
    {
      "text": "100 mg, IV, q12hr",
      "_text": {
        "extension": [
          {
            "url": "https://fhir-ehr.cerner.com/dstu2/StructureDefinition/patient-friendly-display",
            "valueString": "Intravenous every 12 hours for 6 Days. Refills: 0."
          }
        ]
      },
      "timing": {
        "repeat": {
          "boundsQuantity": {
            "value": 6,
            "unit": "days",
            "system": "http://unitsofmeasure.org",
            "code": "d"
          }
        },
        "code": {
          "text": "q12hr"
        }
      },
      "route": {
        "coding": [
          {
            "system": "http://ncimeta.nci.nih.gov",
            "code": "C38276",
            "display": "INTRAVENOUS",
            "userSelected": false
          }
        ],
        "text": "IV"
      },
      "quantityQuantity": {
        "value": 100.0,
        "unit": "mL",
        "system": "http://unitsofmeasure.org",
        "code": "mL"
      }
    }
  ]
}

Errors

The common errors may be returned.

Create

Create a new MedicationStatement.

POST /MedicationStatement

Implementation Notes

Authorization Types

Headers

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

Body Fields

Name Required Cardinality Type
resourceType Yes 1..1 string
  • Description
    • The type of the FHIR resource.
  • Example
    • {
        "resourceType: "MedicationStatement"
      }
      
  • Notes
    • resourceType must be MedicationStatement
patient Yes 1..1 Reference (Patient)
  • Description
    • Who is/was taking the medication.
  • Example
    • {
        "patient": {
          "reference": "Patient/5366327"
        }
      }
      
status Yes 1..1 code
  • Description
    • A code representing the patient or other source's judgment about the state of the medication used that this statement is about.
  • Example
    • {
        "status": "active"
      }
      
effectivePeriod No 0..1 Period
  • Description
    • The interval of time during which it is being asserted that the patient was taking the medication.
  • Example
    • {
        "effectivePeriod": {
          "start": "2015-05-05T14:00:00.000Z",
          "end": "2015-05-06T01:00:00.000Z"
        }
      }
      
  • Notes
    • If effectivePeriod and dosage.timing.repeat.boundsPeriod are both populated they need to be the same value.
note No 0..1 string
  • Description
    • Provides extra information about the medication statement that is not conveyed by the other attributes.
  • Example
    • {
        "note": "do not take with alcohol"
      }
      
medication[x] Yes 1..1 CodeableConcept | contained Reference (Medication)
  • Description
    • Identifies the medication being administered.
  • Example
    • {
        "medicationReference": {
          "reference": "#456235",
          "display": "Ibuprofen"
        }
      }
      
      {
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
               "code": "2551",
               "display": "Ciprofloxacin",
               "userSelected": false
            }
          ],
          "text": "ciprofloxacin"
        }
      }
      
dosage No 0..* BackboneElement
  • Description
    • How the medication is/was used by the patient.
  • Notes
    • At most one dosage can be populated.
dosage.text No 0..1 string
  • Description
    • Free text dosage information as reported about a patient's medication use.
  • Example
    • {
        "text": "2, Oral, 2x/Wk, first dose 05/05/15 10:00:00 EDT"
      }
      
dosage.timing No 0..1 Timing
  • Description
    • The timing schedule for giving the medication to the patient.
dosage.timing.repeat No 0..1 Element
  • Description
    • A set of rules that describe when the event should occur.
dosage.timing.repeat.bounds[x] No 0..1 Period | Duration
  • Description
    • Either the length of timing schedule or the outer bounds for start and/or end limits of the timing schedule.
  • Example
    • {
        "boundsPeriod": {
          "start": "2014-11-03T14:38:00.000-05:00"
        }
      }
      
      {
        "boundsQuantity": {
          "value": 10,
          "unit": "days",
          "system": "http://unitsofmeasure.org",
          "code": "d"
        }
      }
      
dosage.timing.repeat.count No 0..1 integer
  • Description
    • A total count of the desired number of repetitions.
  • Example
    • {
        "count": 5
      }
      
dosage.timing.code No 0..1 CodeableConcept
  • Description
    • A code for the timing pattern.
  • Example
    • {
        "code": {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/vs/GTSAbbreviation",
              "code": "TID",
              "display": "TID"
            }
          ],
          "text": "TID"
        }
      }
      
dosage.asNeeded[x] No 0..1 boolean | CodeableConcept
  • Description
    • Whether the Medication is only taken when needed within a specific dosing schedule.
  • Example
    • {
        "asNeededCodeableConcept": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "25064002",
              "display": "for headache"
            }
          ]
        }
      }
      
      {
        "asNeededBoolean" : true
      }
      
dosage.siteCodeableConcept No 0..1 CodeableConcept
  • Description
    • Where on the body the medication is/was administered.
  • Example
    • {
        "siteCodeableConcept": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "368208006",
              "display": "left upper arm structure (body structure)"
            }
          ],
          "text": "Left Arm"
        }
      }
      
dosage.route No 0..1 CodeableConcept
  • Description
    • A code specifying the route or physiological path of administration of a therapeutic agent into or onto a subject.
  • Example
    • {
        "route": {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "41974700",
              "display": "Chew (qualifier value)"
            }
          ],
          "text": "Chewed"
        }
      }
      
dosage.quantityQuantity No 0..1 SimpleQuantity
  • Description
    • The amount of therapeutic or other substance given at one administration event.
  • Example
    • {
        "quantityQuantity": {
          "value": 2,
          "unit": "tabs",
          "system": "http://unitsofmeasure.org",
          "code": "tbl"
        }
      }
      

Contained Medication Body Fields

Name Required Cardinality Type
code No 0..1 CodeableConcept
  • Description
    • Codes that identify this medication.
  • Example
    • {
        "code": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
              "code": "2551",
              "display": "Ciprofloxacin",
              "userSelected": false
            }
          ],
          "text": "ciprofloxacin"
        }
      }
      
product No 0..* BackboneElement
  • Description
    • Information that applies only to products (not packages).
product.form No 0..1 CodeableConcept
  • Description
    • Describes the form of the item.

Example

Request

POST https://fhir-ehr.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/

Body

{
  "resourceType": "MedicationStatement",
  "contained": [
    {
      "resourceType": "Medication",
      "id": "123",
      "code": {
        "text": "FHIR Test Medication"
      }
    }
  ],
  "patient": {
    "reference": "Patient/234"
  },
  "status": "active",
  "medicationReference": {
    "reference": "#123"
  },
  "dosage": [
    {
      "timing": {
        "code": {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/vs/GTSAbbreviation",
              "code": "BID"
            }
          ],
          "text": "BID"
        }
      },
      "quantityQuantity": {
        "value": 60.0,
        "units": "mg",
        "system": "http://unitsofmeasure.org",
        "code": "mg"
      }
    }
  ]
}

Response

Status: 201 Created
    Connection → Keep-Alive
    Content-Encoding → gzip
    Content-Length → 20
    Content-Type → text/html; charset=UTF-8
    Date → Wed, 13 Jan 2016 21:45:47 GMT
    Keep-Alive → timeout=15, max=100
    Last-Modified → Tue, 15 Dec 2015 19:13:20 GMT
    Status → 201 Created
    access-control-allow-methods → DELETE, GET, POST, PUT, OPTIONS, HEAD
    access-control-allow-origin → *
    access-control-expose-headers → ETag, Content-Location, Location, X-Request-Id, WWW-Authenticate, Date
    access-control-max-age → 0
    cache-control → no-cache
    etag → W/"0"
    location → https://fhir-ehr.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/20465903
    server-response-time → 1260.984596
    strict-transport-security → max-age=631152000
    vary → Origin,User-Agent,Accept-Encoding
    x-content-type-options → nosniff
    x-frame-options → SAMEORIGIN
    x-request-id → 682c633c-b20f-4f6f-8fae-c58b3aeffe04
    x-runtime → 1.260940
    x-xss-protection → 1; mode=block

The ETag response header indicates the current If-Match version to use on subsequent updates.

Errors

The common errors may be returned.

Update

Update a MedicationStatement.

PUT /MedicationStatement/:id

Implementation Notes

Authorization Types

Headers

Authorization: <OAuth2 Bearer Token>
Accept: application/json+fhir
Content-Type: application/json+fhir
If-Match: W/"<Current version of the MedicationStatement resource>"

Body fields

Name Required Cardinality Type
resourceType Yes 1..1 string
  • Description
    • The type of the FHIR resource.
  • Example
    • {
        "resourceType: "MedicationStatement"
      }
      
  • Notes
    • resourceType must be MedicationStatement
id Yes 0..1 id
  • Description
    • The logical id of the resource to update.
  • Example
    • {
        "id": "123412"
      }
      
patient Yes 1..1 Reference (Patient)
  • Description
    • Who is/was taking the medication.
  • Example
    • {
        "patient": {
          "reference": "Patient/5366327"
        }
      }
      
status Yes 1..1 code
  • Description
    • A code representing the patient or other source's judgment about the state of the medication used that this statement is about.
  • Example
    • {
        "status": "active"
      }
      
medication[x] Yes 1..1 CodeableConcept | contained Reference (Medication)
  • Description
    • Identifies the medication being administered.
  • Example
    • {
        "medicationReference": {
          "reference": "#456235",
          "display": "Ibuprofen"
        }
      }
      
      {
        "medicationCodeableConcept": {
          "coding": [
            {
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
               "code": "2551",
               "display": "Ciprofloxacin",
               "userSelected": false
            }
          ],
          "text": "ciprofloxacin"
        }
      }
      
  • Notes
    • This must be the current medication. It cannot be modified.

Example

Request

PUT https://fhir-ehr.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/MedicationStatement/222

Body

{
  "resourceType": "MedicationStatement",
  "id": "222",
  "contained": [
    {
      "resourceType": "Medication",
      "id": "123",
      "code": {
        "text": "FHIR Test Medication"
      }
    }
  ],
  "status": "completed",
  "patient": {
    "reference": "Patient/234"
  },
  "medicationReference": {
    "reference": "#123"
  }
}

Response

Status: 200 OK
    Connection → Keep-Alive
    Content-Encoding → gzip
    Content-Length → 20
    Content-Type → text/html; charset=UTF-8
    Date → Wed, 13 Jan 2016 21:50:53 GMT
    Keep-Alive → timeout=15, max=100
    Last-Modified → Tue, 15 Dec 2015 19:13:20 GMT
    Status → 200 OK
    access-control-allow-methods → DELETE, GET, POST, PUT, OPTIONS, HEAD
    access-control-allow-origin → *
    access-control-expose-headers → ETag, Content-Location, Location, X-Request-Id, WWW-Authenticate, Date
    access-control-max-age → 0
    cache-control → no-cache
    etag → W/"1"
    server-response-time → 653.7616069999999
    strict-transport-security → max-age=631152000
    vary → Origin,User-Agent,Accept-Encoding
    x-content-type-options → nosniff
    x-frame-options → SAMEORIGIN
    x-request-id → 9dba8326-899a-406f-a125-3fc3d6605dad
    x-runtime → 0.653722
    x-xss-protection → 1; mode=block

The ETag response header indicates the current If-Match version to use on subsequent updates.

Errors

The common errors may be returned.

In addition, the following error may be returned: