# MedicationRequest

Canonical page: https://docs.ovok.com/api/fhir/r4/medication-request

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.

These interaction paths describe standard FHIR R4 patterns. Availability can depend on the API capabilities enabled for your Ovok project.

| **Interaction** | **Method** | **Path** |
| --- | --- | --- |
| Read | `GET` | `/fhir/R4/MedicationRequest/[id]` |
| Vread | `GET` | `/fhir/R4/MedicationRequest/[id]/_history/[vid]` |
| Update | `PUT` | `/fhir/R4/MedicationRequest/[id]` |
| Patch | `PATCH` | `/fhir/R4/MedicationRequest/[id]` |
| Delete | `DELETE` | `/fhir/R4/MedicationRequest/[id]` |
| Create | `POST` | `/fhir/R4/MedicationRequest` |
| Search | `GET` | `/fhir/R4/MedicationRequest` |
| History | `GET` | `/fhir/R4/MedicationRequest/[id]/_history` |

## Top-level elements [#top-level-elements]

| **Element** | **Type** | **Cardinality** | **Description** |
| --- | --- | --- | --- |
| <span id="element-id"></span>`id` | [string](/fhir-elements/primitive/string) | `0..1` | Logical id of this artifact |
| <span id="element-meta"></span>`meta` | [Meta](/fhir-elements/complex/meta) | `0..1` | Metadata about the resource |
| <span id="element-implicit-rules"></span>`implicitRules` | [uri](/fhir-elements/primitive/uri) | `0..1` | A set of rules under which this content was created |
| <span id="element-language"></span>`language` | [code](/fhir-elements/primitive/code) | `0..1` | Language of the resource content |
| <span id="element-text"></span>`text` | [Narrative](/fhir-elements/complex/narrative) | `0..1` | Text summary of the resource, for human interpretation |
| <span id="element-contained"></span>`contained` | [Resource](/fhir-elements/foundation/resource) | `0..*` | Contained, inline Resources |
| <span id="element-extension"></span>`extension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Additional content defined by implementations |
| <span id="element-modifier-extension"></span>`modifierExtension` | [Extension](/fhir-elements/complex/extension) | `0..*` | Extensions that cannot be ignored |
| <span id="element-identifier"></span>`identifier` | [Identifier](/fhir-elements/complex/identifier) | `0..*` | External ids for this request |
| <span id="element-status"></span>`status` | [code](/fhir-elements/primitive/code) | `1..1` | active \| on-hold \| cancelled \| completed \| entered-in-error \| stopped \| draft \| unknown |
| <span id="element-status-reason"></span>`statusReason` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Reason for current status |
| <span id="element-intent"></span>`intent` | [code](/fhir-elements/primitive/code) | `1..1` | proposal \| plan \| order \| original-order \| reflex-order \| filler-order \| instance-order \| option |
| <span id="element-category"></span>`category` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | Type of medication usage |
| <span id="element-priority"></span>`priority` | [code](/fhir-elements/primitive/code) | `0..1` | routine \| urgent \| asap \| stat |
| <span id="element-do-not-perform"></span>`doNotPerform` | [boolean](/fhir-elements/primitive/boolean) | `0..1` | True if request is prohibiting action |
| <span id="element-reported-x"></span>`reported[x]` | [boolean](/fhir-elements/primitive/boolean), [Reference](/fhir-elements/complex/reference) | `0..1` | Reported rather than primary record |
| <span id="element-medication-x"></span>`medication[x]` | [CodeableConcept](/fhir-elements/complex/codeable-concept), [Reference](/fhir-elements/complex/reference) | `1..1` | Medication to be taken |
| <span id="element-subject"></span>`subject` | [Reference](/fhir-elements/complex/reference) | `1..1` | Who or group medication request is for |
| <span id="element-encounter"></span>`encounter` | [Reference](/fhir-elements/complex/reference) | `0..1` | Encounter created as part of encounter/admission/stay |
| <span id="element-supporting-information"></span>`supportingInformation` | [Reference](/fhir-elements/complex/reference) | `0..*` | Information to support ordering of the medication |
| <span id="element-authored-on"></span>`authoredOn` | [dateTime](/fhir-elements/primitive/date-time) | `0..1` | When request was initially authored |
| <span id="element-requester"></span>`requester` | [Reference](/fhir-elements/complex/reference) | `0..1` | Who/What requested the Request |
| <span id="element-performer"></span>`performer` | [Reference](/fhir-elements/complex/reference) | `0..1` | Intended performer of administration |
| <span id="element-performer-type"></span>`performerType` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Desired kind of performer of the medication administration |
| <span id="element-recorder"></span>`recorder` | [Reference](/fhir-elements/complex/reference) | `0..1` | Person who entered the request |
| <span id="element-reason-code"></span>`reasonCode` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..*` | Reason or indication for ordering or not ordering the medication |
| <span id="element-reason-reference"></span>`reasonReference` | [Reference](/fhir-elements/complex/reference) | `0..*` | Condition or observation that supports why the prescription is being written |
| <span id="element-instantiates-canonical"></span>`instantiatesCanonical` | [canonical](/fhir-elements/primitive/canonical) | `0..*` | Instantiates FHIR protocol or definition |
| <span id="element-instantiates-uri"></span>`instantiatesUri` | [uri](/fhir-elements/primitive/uri) | `0..*` | Instantiates external protocol or definition |
| <span id="element-based-on"></span>`basedOn` | [Reference](/fhir-elements/complex/reference) | `0..*` | What request fulfills |
| <span id="element-group-identifier"></span>`groupIdentifier` | [Identifier](/fhir-elements/complex/identifier) | `0..1` | Composite request this is part of |
| <span id="element-course-of-therapy-type"></span>`courseOfTherapyType` | [CodeableConcept](/fhir-elements/complex/codeable-concept) | `0..1` | Overall pattern of medication administration |
| <span id="element-insurance"></span>`insurance` | [Reference](/fhir-elements/complex/reference) | `0..*` | Associated insurance coverage |
| <span id="element-note"></span>`note` | [Annotation](/fhir-elements/complex/annotation) | `0..*` | Information about the prescription |
| <span id="element-dosage-instruction"></span>`dosageInstruction` | [Dosage](/fhir-elements/complex/dosage) | `0..*` | How the medication should be taken |
| <span id="element-dispense-request"></span>`dispenseRequest` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..1` | Medication supply authorization |
| <span id="element-substitution"></span>`substitution` | [BackboneElement](/fhir-elements/complex/backbone-element) | `0..1` | Any restrictions on medication substitution |
| <span id="element-prior-prescription"></span>`priorPrescription` | [Reference](/fhir-elements/complex/reference) | `0..1` | An order/prescription that is being replaced |
| <span id="element-detected-issue"></span>`detectedIssue` | [Reference](/fhir-elements/complex/reference) | `0..*` | Clinical Issue with action |
| <span id="element-event-history"></span>`eventHistory` | [Reference](/fhir-elements/complex/reference) | `0..*` | A list of events of interest in the lifecycle |

## Resource-specific search parameters [#resource-specific-search-parameters]

| **Parameter** | **Type** | **Description** |
| --- | --- | --- |
| `authoredon` | date | Return prescriptions written on this date |
| `category` | token | Returns prescriptions with different categories |
| `code` | token | Multiple Resources: AllergyIntolerance: Code that identifies the allergy or intolerance ; Condition: Code for the condition ; DeviceRequest: Code for what is being requested/ordered ; DiagnosticReport: The code for the report, as opposed to codes for the atomic results, which are the names on the observation resource referred to from the result ; FamilyMemberHistory: A search by a condition code ; List: What the purpose of this list is ; Medication: Returns medications for a specific code ; MedicationAdministration: Return administrations of this medication code ; MedicationDispense: Returns dispenses of this medicine code ; MedicationRequest: Return prescriptions of this medication code ; MedicationStatement: Return statements of this medication code ; Observation: The code of the observation type ; Procedure: A code to identify a  procedure ; ServiceRequest: What is being requested/ordered  |
| `date` | date | Multiple Resources: MedicationRequest: Returns medication request to be administered on a specific date  |
| `encounter` | reference | Multiple Resources: MedicationRequest: Return prescriptions with this encounter identifier  |
| `identifier` | token | Multiple Resources: AllergyIntolerance: External ids for this item ; CarePlan: External Ids for this plan ; CareTeam: External Ids for this team ; Composition: Version-independent identifier for the Composition ; Condition: A unique identifier of the condition record ; Consent: Identifier for this record (external references) ; DetectedIssue: Unique id for the detected issue ; DeviceRequest: Business identifier for request/order ; DiagnosticReport: An identifier for the report ; DocumentManifest: Unique Identifier for the set of documents ; DocumentReference: Master Version Specific Identifier ; Encounter: Identifier(s) by which this encounter is known ; EpisodeOfCare: Business Identifier(s) relevant for this EpisodeOfCare ; FamilyMemberHistory: A search by a record identifier ; Goal: External Ids for this goal ; ImagingStudy: Identifiers for the Study, such as DICOM Study Instance UID and Accession number ; Immunization: Business identifier ; List: Business identifier ; MedicationAdministration: Return administrations with this external identifier ; MedicationDispense: Returns dispenses with this external identifier ; MedicationRequest: Return prescriptions with this external identifier ; MedicationStatement: Return statements with this external identifier ; NutritionOrder: Return nutrition orders with this external identifier ; Observation: The unique id for a particular observation ; Procedure: A unique identifier for a procedure ; RiskAssessment: Unique identifier for the assessment ; ServiceRequest: Identifiers assigned to this order ; SupplyDelivery: External identifier ; SupplyRequest: Business Identifier for SupplyRequest ; VisionPrescription: Return prescriptions with this external identifier  |
| `intended-dispenser` | reference | Returns prescriptions intended to be dispensed by this Organization |
| `intended-performer` | reference | Returns the intended performer of the administration of the medication request |
| `intended-performertype` | token | Returns requests for a specific type of performer |
| `intent` | token | Returns prescriptions with different intents |
| `medication` | reference | Multiple Resources: MedicationAdministration: Return administrations of this medication resource ; MedicationDispense: Returns dispenses of this medicine resource ; MedicationRequest: Return prescriptions for this medication reference ; MedicationStatement: Return statements of this medication reference  |
| `patient` | reference | Multiple Resources: AllergyIntolerance: Who the sensitivity is for ; CarePlan: Who the care plan is for ; CareTeam: Who care team is for ; ClinicalImpression: Patient or group assessed ; Composition: Who and/or what the composition is about ; Condition: Who has the condition? ; Consent: Who the consent applies to ; DetectedIssue: Associated patient ; DeviceRequest: Individual the service is ordered for ; DeviceUseStatement: Search by subject - a patient ; DiagnosticReport: The subject of the report if a patient ; DocumentManifest: The subject of the set of documents ; DocumentReference: Who/what is the subject of the document ; Encounter: The patient or group present at the encounter ; EpisodeOfCare: The patient who is the focus of this episode of care ; FamilyMemberHistory: The identity of a subject to list family member history items for ; Flag: The identity of a subject to list flags for ; Goal: Who this goal is intended for ; ImagingStudy: Who the study is about ; Immunization: The patient for the vaccination record ; List: If all resources have the same subject ; MedicationAdministration: The identity of a patient to list administrations  for ; MedicationDispense: The identity of a patient to list dispenses  for ; MedicationRequest: Returns prescriptions for a specific patient ; MedicationStatement: Returns statements for a specific patient. ; NutritionOrder: The identity of the person who requires the diet, formula or nutritional supplement ; Observation: The subject that the observation is about (if patient) ; Procedure: Search by subject - a patient ; RiskAssessment: Who/what does assessment apply to? ; ServiceRequest: Search by subject - a patient ; SupplyDelivery: Patient for whom the item is supplied ; VisionPrescription: The identity of a patient to list dispenses for  |
| `priority` | token | Returns prescriptions with different priorities |
| `requester` | reference | Returns prescriptions prescribed by this prescriber |
| `status` | token | Multiple Resources: MedicationAdministration: MedicationAdministration event status (for example one of active/paused/completed/nullified) ; MedicationDispense: Returns dispenses with a specified dispense status ; MedicationRequest: Status of the prescription ; MedicationStatement: Return statements that match the given status  |
| `subject` | reference | The identity of a patient to list orders  for |

## Reference [#reference]

Official FHIR R4 spec: [MedicationRequest](https://hl7.org/fhir/R4/medicationrequest.html).  
Maturity: Trial Use 3 (FMM 3).
