--- schema_version: "1" id: edfbe69bdf20c337d5ed4ddbbe864d076e64bf51f41dda1024c64b2d373c115d title: ResearchStudy collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/sforce_api_objects_researchstudy.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_objects_researchstudy.htm source_site: developer.salesforce.com content_type: documentation content_hash: d95c04e59911f747c6942a4331185e10afd70c0b5a125dbcf50bc3b72975fdc6 description: Represents the details of a research study that include its design, execution, and oversight. This object is available in API version 61.0 and later. --- # ResearchStudy Represents the details of a research study that include its design, execution, and oversight. This object is available in API version 61.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields ### ActlFirstPtcpEnrlDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the first participant was enrolled in the study at a participating clinical trial site. This field is available in API version 64.0 and later when Site Management is enabled. ### ActlFstPtcpFstVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the first enrolled participant across all sites had their initial study visit, as specified in the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### ActlFstPtcpLastVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the first enrolled participant across all sites completed their final scheduled study visit, as outlined in the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### ActlLastPtcpEnrlDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the final participant was enrolled in the study across all participating clinical trial sites. This field is available in API version 64.0 and later when Site Management is enabled. ### ActlLastPtcpFstVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the last enrolled participant across all sites had their initial study visit, as defined by the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### ActlLastPtcpLastVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the last enrolled participant across all sites completed their final scheduled study visit, as outlined in the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### ActualFinalDbLockDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The actual date when the final database lock is implemented across the clinical trial sites. This field is available in API version 64.0 and later when Site Management is enabled. ### BiospecRetention - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Specifies the retention of the collected participant samples in a biorepository. This field is available in API version 62.0 and later. - **Possible values**: - None Retained - Samples With DNA - Samples Without DNA ### BlindingTypeCodeId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Blinding Type of the Care Program. This field is a polymorphic relationship field. - **Relationship Name**: BlindingTypeCode - **Refers To**: CodeSet, CodeSetBundle ### CareProgramId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The care program associated with the research study. This field is a relationship field. - **Relationship Name**: CareProgram - **Refers To**: CareProgram ### CareSpecialtyId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The care specialty associated with the research study. This field is available in API version 62.0 and later. This field is a relationship field. ### Description - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: A detailed description of the research. ### DiscontinuationReason - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: The reason why the research was discontinued. - **Possible values**: - Accrual Goal Met - Lack of Progress - Temporarily Closed as per Study Design - Toxicity ### EligibleGender - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Specifies the gender that's eligible for the research study. - **Possible values**: - Any - Female - Male - Transgender ### EligibleMaximumAge - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The maximum eligibility age of a candidate for the research study. ### EligibleMinimumAge - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The minimum eligibility age of a candidate for the research study. ### EndDate - **Type**: dateTime - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: The date when the research ends. ### ForcstFirstPtcpEnrlDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The projected date when the first participant enrolls in the study at a participating clinical trial site. This field is available in API version 64.0 and later when Site Management is enabled. ### ForcstFstPtcpLastVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The initially projected date when the first enrolled participant across all sites completes their final scheduled study visit, as defined in the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### ForcstFstPtcpFstVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The projected date when the first enrolled participant across all sites has their initial study visit, such as a screening or baseline visit. This field is available in API version 64.0 and later when Site Management is enabled. ### ForcstLastPtcpEnrlDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The projected date when the final participant enrolls in the study across all participating clinical trial sites. This forecast is based on the planned sample size and recruitment rate. This field is available in API version 64.0 and later when Site Management is enabled. ### ForcstLastPtcpFstVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The projected date when the last enrolled participant across all sites has their initial study visit, as defined by the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### ForcstLastPtcpLastVstDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The initially projected date when the last enrolled participant across all sites completes their final scheduled study visit, as outlined in the study protocol. This field is available in API version 64.0 and later when Site Management is enabled. ### InclusionExclusionCriteria - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: The inclusion criteria and exclusion criteria of the research study. ### IntentType - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: The type of the research, based on the intent of its activities. - **Possible values**: - Basic Science - Device Feasibility - Diagnostic Study - Health Services Research - Prevention - Screening - Supportive Care - Treatment ### 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. ### Name - **Type**: string - **Properties**: Create, Filter, Group, idLookup, Sort, Update - **Description**: The name of the research study. ### 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 ### Phase - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: The current phase of the research. - **Possible values**: - Early Phase 1 - Not Applicable - Phase 1 - Phase 1/Phase 2 - Phase 2 - Phase 2/Phase 3 - Phase 3 - Phase 4 ### PlannedFinalDbLockDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The planned date when the final database lock is implemented across the clinical trial sites. This field is available in API version 64.0 and later when Site Management is enabled. ### PrimaryContactInformationId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The primary phone number of the candidate. This field is a relationship field. - **Relationship Name**: PrimaryContactInformation - **Refers To**: ContactPointPhone ### ProtocolDocumentId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The protocol content document associated with the research study. This field is a relationship field. - **Relationship Name**: ProtocolDocument - **Refers To**: ContentDocument ### PublicationStatus - **Type**: picklist - **Properties**: Create, Filter, Group, Restricted picklist, Sort, Update - **Description**: The publication status of the research study's record. - **Possible values**: - Active - Draft - Retired - Unknown ### ResearchStudyNumber - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The identifier of the research study. ### ShouldAcptHealthyCandidates - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the research study should accept healthy candidates (true) or not (false). - **Default value**: false ### SourceSystem - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The name of the external system that generated the record. ### SourceSystemIdentifier - **Type**: string - **Properties**: Create, Filter, Group, idLookup, Nillable, Sort, Update - **Description**: The ID of the record in the external system. ### SourceSystemModified - **Type**: dateTime - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: The date on which this item was last changed in the source system. ### StartDate - **Type**: dateTime - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: The date when the research starts. ### Summary - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: A brief summary of the research. ### Title - **Type**: textarea - **Properties**: Create, Nillable, Update - **Description**: The human-readable name of the research study. ### Type - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Specifies the type of research study. - **Possible values**: - Interventional - Observational ### UniformResourceIdentifier - **Type**: url - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The canonical identifier of the research study. ## 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. [ResearchStudyChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/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. [ResearchStudyFeed](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/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. [ResearchStudyHistory](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/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. [ResearchStudyShare](https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/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.