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.
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/MedicationDispense/[id] |
| Vread | GET | /fhir/R4/MedicationDispense/[id]/_history/[vid] |
| Update | PUT | /fhir/R4/MedicationDispense/[id] |
| Patch | PATCH | /fhir/R4/MedicationDispense/[id] |
| Delete | DELETE | /fhir/R4/MedicationDispense/[id] |
| Create | POST | /fhir/R4/MedicationDispense |
| Search | GET | /fhir/R4/MedicationDispense |
| History | GET | /fhir/R4/MedicationDispense/[id]/_history |
Top-level elements
| Element | Type | Cardinality | Description |
|---|---|---|---|
id | string | 0..1 | Logical id of this artifact |
meta | Meta | 0..1 | Metadata about the resource |
implicitRules | uri | 0..1 | A set of rules under which this content was created |
language | code | 0..1 | Language of the resource content |
text | Narrative | 0..1 | Text summary of the resource, for human interpretation |
contained | Resource | 0..* | Contained, inline Resources |
extension | Extension | 0..* | Additional content defined by implementations |
modifierExtension | Extension | 0..* | Extensions that cannot be ignored |
identifier | Identifier | 0..* | External identifier |
partOf | Reference | 0..* | Event that dispense is part of |
status | code | 1..1 | preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown |
statusReason[x] | CodeableConcept, Reference | 0..1 | Why a dispense was not performed |
category | CodeableConcept | 0..1 | Type of medication dispense |
medication[x] | CodeableConcept, Reference | 1..1 | What medication was supplied |
subject | Reference | 0..1 | Who the dispense is for |
context | Reference | 0..1 | Encounter / Episode associated with event |
supportingInformation | Reference | 0..* | Information that supports the dispensing of the medication |
performer | BackboneElement | 0..* | Who performed event |
location | Reference | 0..1 | Where the dispense occurred |
authorizingPrescription | Reference | 0..* | Medication order that authorizes the dispense |
type | CodeableConcept | 0..1 | Trial fill, partial fill, emergency fill, etc. |
quantity | Quantity | 0..1 | Amount dispensed |
daysSupply | Quantity | 0..1 | Amount of medication expressed as a timing amount |
whenPrepared | dateTime | 0..1 | When product was packaged and reviewed |
whenHandedOver | dateTime | 0..1 | When product was given out |
destination | Reference | 0..1 | Where the medication was sent |
receiver | Reference | 0..* | Who collected the medication |
note | Annotation | 0..* | Information about the dispense |
dosageInstruction | Dosage | 0..* | How the medication is to be used by the patient or administered by the caregiver |
substitution | BackboneElement | 0..1 | Whether a substitution was performed on the dispense |
detectedIssue | Reference | 0..* | Clinical issue with action |
eventHistory | Reference | 0..* | A list of relevant lifecycle events |
Resource-specific search parameters
| Parameter | Type | Description |
|---|---|---|
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 |
context | reference | Returns dispenses with a specific context (episode or episode of care) |
destination | reference | Returns dispenses that should be sent to a specific destination |
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 |
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 |
performer | reference | Returns dispenses performed by a specific individual |
prescription | reference | Multiple Resources: MedicationDispense: The identity of a prescription to list dispenses from |
receiver | reference | The identity of a receiver to list dispenses for |
responsibleparty | reference | Returns dispenses with the specified responsible party |
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 for whom to list dispenses |
type | token | Returns dispenses of a specific type |
whenhandedover | date | Returns dispenses handed over on this date |
whenprepared | date | Returns dispenses prepared on this date |
Reference
Official FHIR R4 spec: MedicationDispense.
Maturity: Trial Use 2 (FMM 2).