> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MedicationRequest

> 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.

## Properties

| Name                     | Required | Type                                                                                                                                                                                                                                                                                                                                                                                                               | Description                                                                                      |
| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| identifier               | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                                                                                                                                                                                                                                                                                           | External ids for this request                                                                    |
| status                   | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                               | active / on-hold / cancelled / completed / entered-in-error / stopped / draft / unknown          |
| statusReason             | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Reason for current status                                                                        |
| intent                   | Yes      | code                                                                                                                                                                                                                                                                                                                                                                                                               | proposal / plan / order / original-order / reflex-order / filler-order / instance-order / option |
| category                 | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                 | Type of medication usage                                                                         |
| priority                 | No       | code                                                                                                                                                                                                                                                                                                                                                                                                               | routine / urgent / asap / stat                                                                   |
| doNotPerform             | No       | boolean                                                                                                                                                                                                                                                                                                                                                                                                            | True if request is prohibiting action                                                            |
| reported\[x]             | No       | boolean, Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Organization](/medical-api/fhir/resources/organization)>                                                                                          | Reported rather than primary record                                                              |
| medication\[x]           | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), Reference\<[Medication](/medical-api/fhir/resources/medication)>                                                                                                                                                                                                                                                                                  | Medication to be taken                                                                           |
| subject                  | Yes      | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Group](/medical-api/fhir/resources/group)>                                                                                                                                                                                                                                                                                                            | Who or group medication request is for                                                           |
| encounter                | No       | Reference\<[Encounter](/medical-api/fhir/resources/encounter)>                                                                                                                                                                                                                                                                                                                                                     | Encounter created as part of encounter/admission/stay                                            |
| supportingInformation    | No       | Reference\<Resource>\[]                                                                                                                                                                                                                                                                                                                                                                                            | Information to support ordering of the medication                                                |
| authoredOn               | No       | dateTime                                                                                                                                                                                                                                                                                                                                                                                                           | When request was initially authored                                                              |
| requester                | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Organization](/medical-api/fhir/resources/organization) / [Patient](/medical-api/fhir/resources/patient) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [Device](/medical-api/fhir/resources/device)>                                                    | Who/What requested the Request                                                                   |
| performer                | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole) / [Organization](/medical-api/fhir/resources/organization) / [Patient](/medical-api/fhir/resources/patient) / [Device](/medical-api/fhir/resources/device) / [RelatedPerson](/medical-api/fhir/resources/relatedperson) / [CareTeam](/medical-api/fhir/resources/careteam)> | Intended performer of administration                                                             |
| performerType            | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Desired kind of performer of the medication administration                                       |
| recorder                 | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole)>                                                                                                                                                                                                                                                                            | Person who entered the request                                                                   |
| reasonCode               | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                                                                                                                                                                                                                                                                                                 | Reason or indication for ordering or not ordering the medication                                 |
| reasonReference          | No       | Reference\<[Condition](/medical-api/fhir/resources/condition) / [Observation](/medical-api/fhir/resources/observation)>\[]                                                                                                                                                                                                                                                                                         | Condition or observation that supports why the prescription is being written                     |
| instantiatesCanonical    | No       | canonical\[]                                                                                                                                                                                                                                                                                                                                                                                                       | Instantiates FHIR protocol or definition                                                         |
| instantiatesUri          | No       | uri\[]                                                                                                                                                                                                                                                                                                                                                                                                             | Instantiates external protocol or definition                                                     |
| basedOn                  | No       | Reference\<[CarePlan](/medical-api/fhir/resources/careplan) / [MedicationRequest](/medical-api/fhir/resources/medicationrequest) / [ServiceRequest](/medical-api/fhir/resources/servicerequest) / [ImmunizationRecommendation](/medical-api/fhir/resources/immunizationrecommendation)>\[]                                                                                                                         | What request fulfills                                                                            |
| groupIdentifier          | No       | [Identifier](/medical-api/fhir/data-types/identifier)                                                                                                                                                                                                                                                                                                                                                              | Composite request this is part of                                                                |
| courseOfTherapyType      | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Overall pattern of medication administration                                                     |
| insurance                | No       | Reference\<[Coverage](/medical-api/fhir/resources/coverage) / [ClaimResponse](/medical-api/fhir/resources/claimresponse)>\[]                                                                                                                                                                                                                                                                                       | Associated insurance coverage                                                                    |
| note                     | No       | [Annotation](/medical-api/fhir/data-types/annotation)\[]                                                                                                                                                                                                                                                                                                                                                           | Information about the prescription                                                               |
| dosageInstruction        | No       | [Dosage](/medical-api/fhir/data-types/dosage)\[]                                                                                                                                                                                                                                                                                                                                                                   | How the medication should be taken                                                               |
| dispenseRequest          | No       | MedicationRequestDispenseRequest                                                                                                                                                                                                                                                                                                                                                                                   | Medication supply authorization                                                                  |
| - id                     | No       | string                                                                                                                                                                                                                                                                                                                                                                                                             | Unique id for inter-element referencing                                                          |
| - extension              | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                             | Additional content defined by implementations                                                    |
| - modifierExtension      | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                             | Extensions that cannot be ignored even if unrecognized                                           |
| - initialFill            | No       | MedicationRequestDispenseRequestInitialFill                                                                                                                                                                                                                                                                                                                                                                        | First fill details                                                                               |
| - id                     | No       | string                                                                                                                                                                                                                                                                                                                                                                                                             | Unique id for inter-element referencing                                                          |
| - extension              | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                             | Additional content defined by implementations                                                    |
| - modifierExtension      | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                             | Extensions that cannot be ignored even if unrecognized                                           |
| - quantity               | No       | [Quantity](/medical-api/fhir/data-types/quantity)                                                                                                                                                                                                                                                                                                                                                                  | First fill quantity                                                                              |
| - duration               | No       | [Duration](/medical-api/fhir/data-types/duration)                                                                                                                                                                                                                                                                                                                                                                  | First fill duration                                                                              |
| - dispenseInterval       | No       | [Duration](/medical-api/fhir/data-types/duration)                                                                                                                                                                                                                                                                                                                                                                  | Minimum period of time between dispenses                                                         |
| - validityPeriod         | No       | [Period](/medical-api/fhir/data-types/period)                                                                                                                                                                                                                                                                                                                                                                      | Time period supply is authorized for                                                             |
| - numberOfRepeatsAllowed | No       | unsignedInt                                                                                                                                                                                                                                                                                                                                                                                                        | Number of refills authorized                                                                     |
| - quantity               | No       | [Quantity](/medical-api/fhir/data-types/quantity)                                                                                                                                                                                                                                                                                                                                                                  | Amount of medication to supply per dispense                                                      |
| - expectedSupplyDuration | No       | [Duration](/medical-api/fhir/data-types/duration)                                                                                                                                                                                                                                                                                                                                                                  | Number of days supply per dispense                                                               |
| - performer              | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>                                                                                                                                                                                                                                                                                                                                               | Intended dispenser                                                                               |
| substitution             | No       | MedicationRequestSubstitution                                                                                                                                                                                                                                                                                                                                                                                      | Any restrictions on medication substitution                                                      |
| - id                     | No       | string                                                                                                                                                                                                                                                                                                                                                                                                             | Unique id for inter-element referencing                                                          |
| - extension              | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                             | Additional content defined by implementations                                                    |
| - modifierExtension      | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                                                                                                                                                                                                                                                                                             | Extensions that cannot be ignored even if unrecognized                                           |
| - allowed\[x]            | Yes      | boolean, [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                           | Whether substitution is allowed or not                                                           |
| - reason                 | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                                                                                                                                                                                                                                                                                                    | Why should (not) substitution be made                                                            |
| priorPrescription        | No       | Reference\<[MedicationRequest](/medical-api/fhir/resources/medicationrequest)>                                                                                                                                                                                                                                                                                                                                     | An order/prescription that is being replaced                                                     |
| detectedIssue            | No       | Reference\<[DetectedIssue](/medical-api/fhir/resources/detectedissue)>\[]                                                                                                                                                                                                                                                                                                                                          | Clinical Issue with action                                                                       |
| eventHistory             | No       | Reference\<[Provenance](/medical-api/fhir/resources/provenance)>\[]                                                                                                                                                                                                                                                                                                                                                | A list of events of interest in the lifecycle                                                    |

## Search Parameters

| Name                   | Type      | Description                                                                    | Expression                                       |
| ---------------------- | --------- | ------------------------------------------------------------------------------ | ------------------------------------------------ |
| code                   | token     | Return prescriptions of this medication code                                   | MedicationRequest.medication                     |
| identifier             | token     | Return prescriptions with this external identifier                             | MedicationRequest.identifier                     |
| patient                | reference | Returns prescriptions for a specific patient                                   | MedicationRequest.subject                        |
| medication             | reference | Return prescriptions for this medication reference                             | MedicationRequest.medication                     |
| status                 | token     | Status of the prescription                                                     | MedicationRequest.status                         |
| authoredon             | date      | Return prescriptions written on this date                                      | MedicationRequest.authoredOn                     |
| category               | token     | Returns prescriptions with different categories                                | MedicationRequest.category                       |
| date                   | date      | Returns medication request to be administered on a specific date               | MedicationRequest.dosageInstruction.timing.event |
| encounter              | reference | Return prescriptions with this encounter identifier                            | MedicationRequest.encounter                      |
| intended-dispenser     | reference | Returns prescriptions intended to be dispensed by this Organization            | MedicationRequest.dispenseRequest.performer      |
| intended-performer     | reference | Returns the intended performer of the administration of the medication request | MedicationRequest.performer                      |
| intended-performertype | token     | Returns requests for a specific type of performer                              | MedicationRequest.performerType                  |
| intent                 | token     | Returns prescriptions with different intents                                   | MedicationRequest.intent                         |
| priority               | token     | Returns prescriptions with different priorities                                | MedicationRequest.priority                       |
| requester              | reference | Returns prescriptions prescribed by this prescriber                            | MedicationRequest.requester                      |
| subject                | reference | The identity of a patient to list orders for                                   | MedicationRequest.subject                        |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [MedicationRequest](https://www.hl7.org/fhir/StructureDefinition/MedicationRequest).
