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

# MedicationDispense

> Indicates that a medication product is to be or has been dispensed for a named person/patient.  This includes a description of the medication product (supply) provided and the instructions for administering the medication.  The medication dispense is the result of a pharmacy system responding to a medication order.

## Properties

| Name | Required | Type | Description |
| - | - | - | - |
| identifier | No | [Identifier](/medical-api/fhir/data-types/identifier)\[] | External identifier |
| partOf | No | Reference\<[Procedure](/medical-api/fhir/resources/procedure)>\[] | Event that dispense is part of |
| status | Yes | code | preparation / in-progress / cancelled / on-hold / completed / entered-in-error / stopped / declined / unknown |
| statusReason\[x] | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), Reference\<[DetectedIssue](/medical-api/fhir/resources/detectedissue)> | Why a dispense was not performed |
| category | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Type of medication dispense |
| medication\[x] | Yes | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), Reference\<[Medication](/medical-api/fhir/resources/medication)> | What medication was supplied |
| subject | No | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Group](/medical-api/fhir/resources/group)> | Who the dispense is for |
| context | No | Reference\<[Encounter](/medical-api/fhir/resources/encounter) / [EpisodeOfCare](/medical-api/fhir/resources/episodeofcare)> | Encounter / Episode associated with event |
| supportingInformation | No | Reference\<Resource>\[] | Information that supports the dispensing of the medication |
| performer | No | MedicationDispensePerformer | Who performed event |
| - 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 |
| - function | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Who performed the dispense and what they did |
| - actor | Yes | 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)> | Individual who was performing |
| location | No | Reference\<[Location](/medical-api/fhir/resources/location)> | Where the dispense occurred |
| authorizingPrescription | No | Reference\<[MedicationRequest](/medical-api/fhir/resources/medicationrequest)>\[] | Medication order that authorizes the dispense |
| type | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Trial fill, partial fill, emergency fill, etc. |
| quantity | No | [Quantity](/medical-api/fhir/data-types/quantity) | Amount dispensed |
| daysSupply | No | [Quantity](/medical-api/fhir/data-types/quantity) | Amount of medication expressed as a timing amount |
| whenPrepared | No | dateTime | When product was packaged and reviewed |
| whenHandedOver | No | dateTime | When product was given out |
| destination | No | Reference\<[Location](/medical-api/fhir/resources/location)> | Where the medication was sent |
| receiver | No | Reference\<[Patient](/medical-api/fhir/resources/patient) / [Practitioner](/medical-api/fhir/resources/practitioner)>\[] | Who collected the medication |
| note | No | [Annotation](/medical-api/fhir/data-types/annotation)\[] | Information about the dispense |
| dosageInstruction | No | [Dosage](/medical-api/fhir/data-types/dosage)\[] | How the medication is to be used by the patient or administered by the caregiver |
| substitution | No | MedicationDispenseSubstitution | Whether a substitution was performed on the dispense |
| - 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 |
| - wasSubstituted | Yes | boolean | Whether a substitution was or was not performed on the dispense |
| - type | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Code signifying whether a different drug was dispensed from what was prescribed |
| - reason | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | Why was substitution made |
| - responsibleParty | No | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole)>\[] | Who is responsible for the substitution |
| 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 relevant lifecycle events |

## Search Parameters

| Name | Type | Description | Expression |
| - | - | - | - |
| code | token | Returns dispenses of this medicine code | MedicationDispense.medication |
| identifier | token | Returns dispenses with this external identifier | MedicationDispense.identifier |
| patient | reference | The identity of a patient to list dispenses for | MedicationDispense.subject |
| medication | reference | Returns dispenses of this medicine resource | MedicationDispense.medication |
| status | token | Returns dispenses with a specified dispense status | MedicationDispense.status |
| context | reference | Returns dispenses with a specific context (episode or episode of care) | MedicationDispense.context |
| destination | reference | Returns dispenses that should be sent to a specific destination | MedicationDispense.destination |
| performer | reference | Returns dispenses performed by a specific individual | MedicationDispense.performer.actor |
| prescription | reference | The identity of a prescription to list dispenses from | MedicationDispense.authorizingPrescription |
| receiver | reference | The identity of a receiver to list dispenses for | MedicationDispense.receiver |
| responsibleparty | reference | Returns dispenses with the specified responsible party | MedicationDispense.substitution.responsibleParty |
| subject | reference | The identity of a patient for whom to list dispenses | MedicationDispense.subject |
| type | token | Returns dispenses of a specific type | MedicationDispense.type |
| whenhandedover | date | Returns dispenses handed over on this date | MedicationDispense.whenHandedOver |
| whenprepared | date | Returns dispenses prepared on this date | MedicationDispense.whenPrepared |

## 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 [MedicationDispense](https://www.hl7.org/fhir/StructureDefinition/MedicationDispense).


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