--- schema_version: "1" id: 5460f62b03bedcefb9c9eef5c62a7ec863157ee27c6915202326f103fbe54270 title: MedicationAdministration collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/hc_r4_objects_medicationadministration.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_objects_medicationadministration.htm source_site: developer.salesforce.com content_type: documentation content_hash: 2a165f86a806e468b1ba50fe69f50e6346c78954369dcec5a159d3b9ea7e3d7e description: Represents an instance of medication administered to a patient. This object is available in API version 64.0 and later. --- # MedicationAdministration Represents an instance of medication administered to a patient. This object is available in API version 64.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() - **[MedicationAdministrationDtl](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_objects_medicationadministrationdtl.htm)** Represents the details of an instance of medication administered to a patient. This object is available in API version 64.0 and later. ## Fields ### ClinicalEncounterId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The clinical encounter associated with the medication administration. This field is a relationship field. - **Relationship Name**: ClinicalEncounter - **Refers To**: ClinicalEncounter ### DeviceCodeId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The device code set bundle associated with the medication administration, representing the device used during the administration. This field is a relationship field. - **Relationship Name**: DeviceCode - **Refers To**: CodeSetBundle ### EndDate - **Type**: dateTime - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: The end date and time when the administration occurred (or didn't occur). ### IsSubPotent - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the full dose wasn’t administered (true) or not (false). - **Default value**: false ### LastReferencedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: The timestamp for when the current user last viewed a record related to this record. ### LastViewedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: The timestamp for when the current user last viewed this record. If this value is null, it’s possible that this record was referenced (LastReferencedDate) and not viewed. ### MedicationId - **Type**: reference - **Properties**: Create, Filter, Group, Sort, Update - **Description**: The medication associated with the medication administration. This field is a relationship field. - **Relationship Name**: Medication - **Refers To**: Medication ### MedicationRequestId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The medication request associated with the medication administration. This field is a relationship field. - **Relationship Name**: MedicationRequest - **Refers To**: MedicationRequest ### Name - **Type**: string - **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort - **Description**: Name of the medication administration. ### OwnerId - **Type**: reference - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: The ID of the user who owns this record. This field is a polymorphic relationship field. - **Relationship Name**: Owner - **Refers To**: Group, User ### PatientId - **Type**: reference - **Properties**: Create, Filter, Group, Sort - **Description**: The patient associated with the medication administration. This field is a relationship field. - **Relationship Name**: Patient - **Relationship Type**: Master-detail - **Refers To**: Account (the master object) ### RecordedDate - **Type**: dateTime - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: The date and time when the occurrence of the medication administration was first captured. ### StartDate - **Type**: dateTime - **Properties**: Create, Filter, Sort, Update - **Description**: The start date and time when the administration occurred (or didn't occur). ### Status - **Type**: picklist - **Properties**: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update - **Description**: Specifies the status of the medication administration. - **Default value**: InProgress - **Possible values**: - Completed - EnteredInError - InProgress - NotAdministered - OnHold - Stopped - Unknown ### StatusReasonCodeId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The status reason code set bundle associated with the medication administration indicating why the administration wasn’t performed. This field is a relationship field. - **Relationship Name**: StatusReasonCode - **Refers To**: CodeSetBundle ### SubPotentReasonId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The sub potent reason code set bundle associated with the medication administration, representing the reason why the full dose wasn’t administered. This field is a relationship field. - **Relationship Name**: SubPotentReason - **Refers To**: CodeSetBundle ### TypeId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The type code set bundle associated with the medication administration that indicates the type of medication administration. This field is a relationship field. - **Relationship Name**: Type - **Refers To**: CodeSetBundle ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [MedicationAdministrationChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_change_event.htm "A StandardObjectNameChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") Change events are available for the object. [MedicationAdministrationHistory](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [MedicationAdministrationOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [MedicationAdministrationShare](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.