MedicationStatement REST Endpoints

Sort by

Task Path Method

Description

MedicationStatement

The following topic describes information for the MedicationStatement resource.

Overview

The MedicationStatement resource provides a snapshot in time of known medications taken by the patient now or in the past, which were reported by the patient, a significant other, or a provider. Future orders are not returned.

Historical, past, or home medications are commonly captured when documenting the patient's medical history. Prescriptions without documented compliance are considered intended because whether the patient is actively taking the medication or has filled the prescription is unknown. Medications are assumed to be taken unless documented otherwise.

The following fields are returned if valued:

• Medication Statement ID

• Patient

• Source of information

• Date/Time recorded

• Status

• Was or Was Not Taken

• Date/Time started and ended

• Medication

• Reference to source MedicationOrder, if applicable

• Category Extension (for more information, see the Extensions section of this topic)

• Details of medication taken:

  • Dosage

  • Route

  • Frequency

  • Quantity

  • Reason for use

  • Site

  • Rate

  • Order comments/special instructions

  • Patient friendly display Extension (for more information, see the Extensions section of this topic)

Querying for Active Medications

To get all possible current medications, an application should query the MedicationStatement resource with the status query parameter set to active,intended. Because the MedicationStatement resource provides a snapshot in time, the reponse includes only the information that was in the system as of the last contact with the patient. Changes in medications that occurred after the patient last visited their provider are not included.

To get the list of current medications that would likely be shown by default to a practitioner, use the MedicationOrder resource and the query above to ensure that draft orders are included. You can use the MedicationStatement.supportingInformation reference to remove duplicates. A duplicate is identified when the MedicationOrder.id is equivalent to the MedicationOrder/[id] in the supportingInformation reference.

Terminology Bindings

• MedicationStatement.reasonForUse[x]

  Description: A reason for why the medication is or was taken.

  • Details: SNOMED CT

    System: http://snomed.info/sct

  • Details: ICD-9

    System: http://hl7.org/fhir/sid/icd-9

  • Details: ICD-10

    System: http://hl7.org/fhir/sid/icd-10

• MedicationStatement.medication[x]

  Description: A code that defines the type of medication.

  Details: RxNorm

  System: http://www.nlm.nih.gov/research/umls/rxnorm

• MedicationStatement.dosage.timing.code

  Description: A code for a known or defined timing pattern.

  • Details: TimingAbbreviation

    System: http://hl7.org/fhir/timing-abbreviation

  • Details: SNOMED CT

    System: http://snomed.info/sct

• MedicationStatement.dosage.asNeeded[x]

  Description: A coded concept identifying the precondition that should be met or evaluated before consuming or administering a medication dose.

  Details: SNOMED CT

  System: http://snomed.info/sct

• MedicationStatement.dosage.siteCodeableConcept

  Description: Where on the body the medication is or was administered.

  Details: SNOMED CT

  System: http://snomed.info/sct

• 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: The form of the item.

  Details: NCI Metathesaurus

  System: http://ncimeta.nci.nih.gov

Contained Practitioner Bindings

• Practitioner.practitionerRole.role

  Description: The roles that this practitioner is authorized to perform for the organization.

  Details: Practitioner Role

  System: http://hl7.org/fhir/practitioner-role

Extensions

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

Table - Extensions

ID	Value[x] Type	Description
patient-friendly-display	String	Extension to MedicationRequest.dosageInstruction. The display name 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, and so on.

MedicationStatement

The operations from the MedicationStatement category.

Create a medication statement

Method: post

Path: /MedicationStatement

Get a list of medication statements

Method: get

Path: /MedicationStatement

Get a medication statement by ID

Method: get

Path: /MedicationStatement/{ID}

Update a medication statement

Method: put

Path: /MedicationStatement/{ID}