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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.