MedicationRequest REST Endpoints

Sort by

Task Path Method

Description

MedicationRequest

This topic describes information for the MedicationRequest resource.

Overview

Note:

The FHIR API endpoints described below are currently pending production deployment for electronic health record (EHR) environments. Developers are welcome and encouraged to develop against the specifications in anticipation of production availability, which will be announced at a later date.

The MedicationRequest resource provides orders for all medications with administration instructions for a patient in both the inpatient and outpatient settings (orders or prescriptions filled by a pharmacy and discharge medication orders). This resource also includes a patient's historical or documented home medications reported by the patient, significant other, or another provider.

If the medication request represents a prescription the patient takes at home, then the start, stop, and other information may not be a representation of when the medication was taken. For example, the system may not know if the patient ever filled or took the prescribed medication, or when the prescription was filled. Documented historical, past, and home medications are commonly captured when taking the patient's medical history.

MedicationRequest.medication may be a reference to a contained medication when the medication cannot be represented by a CodeableConcept because it contains a unique combination of ingredients. Medications in the system exist in the context of a medication request and cannot be referenced independently.

Profile Support

This resource supports the following HL7 FHIR US Core Implementation Guide STU 6.1.0 profiles:

• US Core MedicationRequest Profile
  • US Core Medication Profile

Note:

The examples provided here are nonnormative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Returned Fields

Element	Type
MedicationRequest.id	id
MedicationRequest.status	code
MedicationRequest.category	codeableconcept
MedicationRequest.reported[x]	boolean Reference(Patient)
MedicationRequest.medication[x]	CodeableConcept Reference(Medication)
MedicationRequest.subject	Reference(Patient)
MedicationRequest.encounter	Reference(Encounter
MedicationRequest.authoredOn	dateTime
MedicationRequest.requester	Reference(Practitioner)
MedicationRequest.dosageInstruction	Dosage
MedicationRequest.dosageInstruction.text	String
MedicationRequest.dosageInstruction.timing	Timing
MedicationRequest.dosageInstruction.doseAndRate	Element
MedicationRequest.dosageInstruction.doseAndRate.dose[x]	Range SimpleQuantity
MedicationRequest.dispenseRequest	BackboneElement
MedicationRequest.dispenseRequest.numberofRepeatsAllowed	unsignedInt
MedicationRequest.dispenseRequest.quantity	Simplequantity

Terminology Bindings

Element	Description	Details
MedicationRequest.status	The current state of the medication request.	SYSTEM
MedicationRequest.category	The type of medication request.	Request Category Codes Usage Category Codes
MedicationRequest.medication[x]	A code that defines the medication.	RxNorm
MedicationRequest.dosageInstruction.timing.code	A code for a known or defined timing pattern.	Abbreviations SNOMED
Medication.code	A code (or set of codes) that specify this medication, or a textual description if no code is available. This code could be a standard medication code such as a code from RxNorm, SNOMED CT, IDMP, and so on. The code could also be a national or local formulary code, optionally with translations to other code systems.	RxNorm
Medication.form	A code that describes the form of the item (powder, tablets, capsule, and so on).	SNOMED CT System

MedicationRequest

The operations from the MedicationRequest category.

Get a list of medication requests

Method: get

Path: /MedicationRequest

Get a medication request by ID

Method: get

Path: /MedicationRequest/{id}