> ## 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\\[] | 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).