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 available for customers to deploy and use. Developers are welcome and encouraged to develop against the specifications in anticipation of customer deployment.

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 is returned as medicationReference for both single-ingredient and multi-ingredient medication requests. To return additional medication details beyond the reference and display, use _include=MedicationRequest:medication when searching.

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.statusReason	CodeableConcept
MedicationRequest.intent	code
MedicationRequest.category	CodeableConcept
MedicationRequest.priority	code
MedicationRequest.reported[x]	boolean
MedicationRequest.medication[x]	Reference(Medication)
MedicationRequest.subject	Reference(Patient)
MedicationRequest.encounter	Reference(Encounter
MedicationRequest.authoredOn	dateTime
MedicationRequest.requester	Reference(Practitioner)
MedicationRequest.reasonCode	CodeableConcept
MedicationRequest.courseOfTherapyType	CodeableConcept
MedicationRequest.note	Annotation
MedicationRequest.dosageInstruction	Dosage
MedicationRequest.dosageInstruction.text	string
MedicationRequest.dosageInstruction.additionalInstruction	CodeableConcept
MedicationRequest.dosageInstruction.patientInstruction	string
MedicationRequest.dosageInstruction.timing	Timing
MedicationRequest.dosageInstruction.timing.repeat	Element
MedicationRequest.dosageInstruction.timing.repeat.boundsPeriod	Period
MedicationRequest.dosageInstruction.timing.repeat.count	positiveInt
MedicationRequest.dosageInstruction.timing.repeat.duration	decimal
MedicationRequest.dosageInstruction.timing.repeat.durationUnit	code
MedicationRequest.dosageInstruction.timing.repeat.when	code
MedicationRequest.dosageInstruction.timing.code	CodeableConcept
MedicationRequest.dosageInstruction.asNeeded[x]	boolean
MedicationRequest.dosageInstruction.site	CodeableConcept
MedicationRequest.dosageInstruction.route	CodeableConcept
MedicationRequest.dosageInstruction.doseAndRate	Element
MedicationRequest.dosageInstruction.doseAndRate.dose[x]	SimpleQuantity
MedicationRequest.dosageInstruction.doseAndRate.rate[x]	SimpleQuantity
MedicationRequest.dispenseRequest	BackboneElement
MedicationRequest.dispenseRequest.validityPeriod	Period
MedicationRequest.dispenseRequest.numberOfRepeatsAllowed	unsignedInt
MedicationRequest.dispenseRequest.quantity	SimpleQuantity
MedicationRequest.dispenseRequest.performer	Reference(Organization)
MedicationRequest.substitution	BackboneElement
MedicationRequest.substitution.allowed[x]	boolean
MedicationRequest.priorPrescription	Reference(MedicationRequest)

Terminology Bindings

Element	Description	Details
MedicationRequest.status	The current state of the medication request.	SYSTEM
MedicationRequest.statusReason	The reason for the current status.	MedicationRequest Status Reason Codes
MedicationRequest.category	The type of medication request.	Request Category Codes Usage Category Codes
MedicationRequest.priority	The medication request priority.	Request Priority
MedicationRequest.reasonCode	The reason why the medication is or was taken.	SNOMED CT ICD-9-CM ICD-10
MedicationRequest.dosageInstruction.timing.code	A code for a known or defined timing pattern.	Abbreviations SNOMED CT
MedicationRequest.dosageInstruction.asNeeded[x]	An indication of whether the medication is only taken when needed or the preconditions for taking the medication.	SNOMED CT
MedicationRequest.dosageInstruction.site	The anatomic site where the medication first enters the body.	SNOMED CT
MedicationRequest.dosageInstruction.route	The route or physiological path of administration of a therapeutic agent into or onto the body.	SNOMED CT
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

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}