--- schema_version: "1" id: e6d4646f75c01fce6fcad2f63c6164f922688e3bc27caf528a536ad16ab9e800 title: ResearchStudyCandidate collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/life_sciences_dev_guide/sforce_api_objects_researchstudycandidate.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.life_sciences_dev_guide.meta/life_sciences_dev_guide/sforce_api_objects_researchstudycandidate.htm source_site: developer.salesforce.com content_type: documentation content_hash: 8da43d5322a784e9ccd46941be0dcf309c7cda1c35e0851bd35b90eb645143f1 description: Represents the details of the research participant which includes the associated account and the status of the subject. This object is available in API version 61.0 and later. --- # ResearchStudyCandidate Represents the details of the research participant which includes the associated account and the status of the subject. 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 ### CandidateId - **Type**: reference - **Properties**: Create, Filter, Group, Sort, Update - **Description**: The candidate of the research study. This field is a polymorphic relationship field. - **Relationship Name**: Candidate - **Refers To**: Account ### CareProgramSiteId - **Type**: reference - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The location where the study happens. This field is a relationship field. - **Relationship Name**: CareProgramSite - **Refers To**: CareProgramSite ### 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. ### MatchedExclusionCritCount - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The number of exclusion criteria fulfilled by the candidate during automatic evaluation. This field is available in API version 62.0 and later. ### MatchedInclusionCritCount - **Type**: int - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The number of inclusion criteria fulfilled by the candidate during automatic evaluation. This field is available in API version 62.0 and later. ### Name - **Type**: string - **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort - **Description**: The name of the research study candidate. ### 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 ### ResearchStudyId - **Type**: reference - **Properties**: Create, Filter, Group, Sort, Update - **Description**: The research study that the Candidate is a part of. This field is a relationship field. - **Relationship Name**: ResearchStudy - **Refers To**: ResearchStudy ### 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. ### SourceType - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: Specifies the type of source from where the information about the candidate is obtained. - **Possible values**: - Others - Participant Registry - Referrals - Site Patient Pool ### Status - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update - **Description**: The status of the research study candidate. - **Possible values**: - Consent - Enrolled - New - Randomization - Referral Accepted - Rejected - Screening ## 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. [researchstudycandidateChangeEvent](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. [researchstudycandidateFeed](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. [researchstudycandidateHistory](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. [researchstudycandidateShare](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.