---
schema_version: "1"
id: 3356dc83e474a736ca24f51255142899675a09df8183b9a0fafa611387cfd134
title: MedicationTherapyReview
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/sforce_api_objects_medicationtherapyreview.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_objects_medicationtherapyreview.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 74c9ae3cab26ed03df35cbfff26073d375737cd4156aa09f6a05c831d1f8aa96
description: Stores information about a medication therapy review conducted for a patient. This object is available in API version 56.0 and later.
---
# MedicationTherapyReview

Stores information about a medication therapy review conducted for a patient. This object is available in API version 56.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### CareProgramId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The care program associated with the medication therapy review.
    
    This field is a relationship field.
- **Relationship Name**: CareProgram
- **Relationship Type**: Lookup
- **Refers To**: CareProgram

### ConductedById

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The user who started the medication therapy review for the patient.
    
    This field is a relationship field.
- **Relationship Name**: ConductedBy
- **Relationship Type**: Lookup
- **Refers To**: User

### Description

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: A description of the medication therapy review conducted for the patient.

### IsPatientInLtrmCareFacility

- **Type**: boolean
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: Indicates whether the patient was at a long-term healthcare facility during the medication therapy review.
- **Default value**: false

### LastReferencedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user referenced the record.

### LastViewedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user viewed the record.

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: The name of the medication therapy review.

### OwnerId

- **Type**: reference
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: The ID of the user who owns the record.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Owner
- **Relationship Type**: Lookup
- **Refers To**: Group, User

### PatientId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort
- **Description**: The patient on whom the medication therapy review is conducted.
    
    This field is a relationship field.
- **Relationship Name**: Patient
- **Relationship Type**: Master-Detail
- **Refers To**: Account

### ReviewDueDateTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the medication therapy review is expected to complete.

### ReviewEndDateTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the medication therapy review is complete.

### ReviewStartDateTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the medication therapy review is initiated.

### ReviewSubtype

- **Type**: multipicklist
- **Properties**: Create, Filter, Nillable, Update
- **Description**: A further classification of the medication therapy review type.

### ReviewType

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: The type of medication therapy review conducted for the patient.
- **Possible values**:
    - ComprehensiveMedicationReview
    - TargetedMedicationReview

### SourceSysModifiedDateTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the record was last modified in its source system.

### SourceSystem

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The source system from where the record was brought into Salesforce.

### SourceSystemIdentifier

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The identifier of the record in its source system.

### Status

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: The current status of the medication therapy review.
- **Possible values**:
    - Cancelled
    - Completed
    - InProgress
    - NotStarted

### SurrogateDecisionMakerId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The authorized representative who attends the medication therapy review and makes health-care related decisions on behalf of a cognitively impaired patient.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: SurrogateDecisionMaker
- **Relationship Type**: Lookup
- **Refers To**: Account, Contact, HealthcareProvider, User

### SurrogateLocationId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The address of the surrogate decision maker where the comprehensive medication review document is delivered.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: SurrogateLocation
- **Relationship Type**: Lookup
- **Refers To**: Address, Location

### SurrogateType

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: The relationship between the surrogate decision maker and the patient.
- **Possible values**:
    - Healthcare Proxy
    - Patient's Guardian of the Estate
    - Patient’s Child
    - Patient’s Friend
    - Patient’s Guardian
    - Patient’s Parent
    - Patient’s Relative
    - Patient’s Sibling
    - Patient’s Spouse

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

[MedicationTherapyReviewFeed](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[MedicationTherapyReviewHistory](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.

[MedicationTherapyReviewShare](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.