Skip to main content

MedicationRequest

ResourceClinical · MedicationsTrial useMaturity 3

An order or request for both supply of the medication and the instructions for administration of the medication to a patient. The resource is called "MedicationRequest" rather than "MedicationPrescription" or "MedicationOrder" to generalize the use across inpatient and outpatient settings, including care plans, etc., and to harmonize with workflow patterns.

Tested supportFull test results →
Backends
PostgreSQLElasticsearch
Interactions
CreateReadUpdatePatchDelete
Search
16 of 16 parameters tested

Structure​

ElementCard.TypeDescription
identifier
0..*IdentifierExternal ids for this request
statusRequired?!Σ
1..1codeactive | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknownBinding (required): medicationrequest-status
statusReason
0..1CodeableConceptReason for current statusBinding (example): medicationrequest-status-reason
intentRequired?!Σ
1..1codeproposal | plan | order | original-order | reflex-order | filler-order | instance-order | optionBinding (required): medicationrequest-intent
category
0..*CodeableConceptType of medication usageBinding (example): medicationrequest-category
priorityΣ
0..1coderoutine | urgent | asap | statBinding (required): request-priority
doNotPerform?!Σ
0..1booleanTrue if request is prohibiting action
reported[x]Σ
0..1boolean | Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)Reported rather than primary record
medication[x]RequiredΣ
1..1CodeableConcept | Reference(Medication)Medication to be takenBinding (example): medication-codes
subjectRequiredΣ
1..1Reference(Patient | Group)Who or group medication request is for
encounter
0..1Reference(Encounter)Encounter created as part of encounter/admission/stay
supportingInformation
0..*Reference(Resource)Information to support ordering of the medication
authoredOnΣ
0..1dateTimeWhen request was initially authored
requesterΣ
0..1Reference(Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)Who/What requested the Request
performer
0..1Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam)Intended performer of administration
performerTypeΣ
0..1CodeableConceptDesired kind of performer of the medication administrationBinding (example): performer-role
recorder
0..1Reference(Practitioner | PractitionerRole)Person who entered the request
reasonCode
0..*CodeableConceptReason or indication for ordering or not ordering the medicationBinding (example): condition-code
reasonReference
0..*Reference(Condition | Observation)Condition or observation that supports why the prescription is being written
instantiatesCanonicalΣ
0..*canonicalInstantiates FHIR protocol or definition
instantiatesUriΣ
0..*uriInstantiates external protocol or definition
basedOnΣ
0..*Reference(CarePlan | MedicationRequest | ServiceRequest | ImmunizationRecommendation)What request fulfills
groupIdentifierΣ
0..1IdentifierComposite request this is part of
courseOfTherapyType
0..1CodeableConceptOverall pattern of medication administrationBinding (example): medicationrequest-course-of-therapy
insurance
0..*Reference(Coverage | ClaimResponse)Associated insurance coverage
note
0..*AnnotationInformation about the prescription
dosageInstruction
0..*DosageHow the medication should be taken
dispenseRequest
0..1BackboneElementMedication supply authorization
initialFill
0..1BackboneElementFirst fill details
quantity
0..1QuantityFirst fill quantity
duration
0..1DurationFirst fill duration
dispenseInterval
0..1DurationMinimum period of time between dispenses
validityPeriod
0..1PeriodTime period supply is authorized for
numberOfRepeatsAllowed
0..1unsignedIntNumber of refills authorized
quantity
0..1QuantityAmount of medication to supply per dispense
expectedSupplyDuration
0..1DurationNumber of days supply per dispense
performer
0..1Reference(Organization)Intended dispenser
substitution
0..1BackboneElementAny restrictions on medication substitution
allowed[x]Required
1..1boolean | CodeableConceptWhether substitution is allowed or notBinding (example): v3-ActSubstanceAdminSubstitutionCode
reason
0..1CodeableConceptWhy should (not) substitution be madeBinding (example): v3-SubstanceAdminSubstitutionReason
priorPrescription
0..1Reference(MedicationRequest)An order/prescription that is being replaced
detectedIssue
0..*Reference(DetectedIssue)Clinical Issue with action
eventHistory
0..*Reference(Provenance)A list of events of interest in the lifecycle

Σ in _summary results · ?! modifier element · 1.. required · inherited elements in grey

Search parameters​

Query with GET [base]/MedicationRequest?[parameter]=[value]. Type decides which modifiers and prefixes apply, see search features.

ParameterTypeDescriptionPGES
authoredondate

Return prescriptions written on this date

MedicationRequest.authoredOn
categorytoken

Returns prescriptions with different categories

MedicationRequest.category
codetoken

Return prescriptions of this medication code

(MedicationRequest.medication.ofType(CodeableConcept))
datedate

Returns medication request to be administered on a specific date

MedicationRequest.dosageInstruction.timing.event
encounterreference

Return prescriptions with this encounter identifier

MedicationRequest.encounter
identifiertoken

Return prescriptions with this external identifier

MedicationRequest.identifier
intended-dispenserreference

Returns prescriptions intended to be dispensed by this Organization

MedicationRequest.dispenseRequest.performer
intended-performerreference

Returns the intended performer of the administration of the medication request

MedicationRequest.performer
intended-performertypetoken

Returns requests for a specific type of performer

MedicationRequest.performerType
intenttoken

Returns prescriptions with different intents

MedicationRequest.intent
medicationreference

Return prescriptions for this medication reference

(MedicationRequest.medication.ofType(Reference))
patientreference

Returns prescriptions for a specific patient

MedicationRequest.subject.where(resolve() is Patient)
prioritytoken

Returns prescriptions with different priorities

MedicationRequest.priority
requesterreference

Returns prescriptions prescribed by this prescriber

MedicationRequest.requester
statustoken

Status of the prescription

MedicationRequest.status
subjectreference

The identity of a patient to list orders for

MedicationRequest.subject

PG: PostgreSQL, ES: Elasticsearch. passes its TestScript checks, fails, not tested yet.

Common parameters on every resource (8)
_haste-health-authorreference

The author of the resource

_idtoken

Logical id of this artifact

_lastUpdateddate

When the resource version last changed

_profileuri

Profiles this resource claims to conform to

_securitytoken

Security Labels applied to this resource

_sourceuri

Identifies where the resource comes from

_tagtoken

Tags applied to this resource

_typetoken

Derived from the R4B Definition