V3 Contracts

Settings Enhanced Conditions Contracts and Attributes

The following lists each contract used in the Settings Enhanced Conditions APIs and describes all the attributes that make up each contract. All attributes are optional unless otherwise specified.

Enhanced Condition Type Contract Attributes

The following objects and attributes make up the EnhancedConditionTypeContract object.

ATTRIBUTEDESCRIPTION
id
string
Unique identifier of the condition, which is guaranteed to be unique. For example:
"3AA5BF62-3C0D-46A7-8ADE-03907BE0A5E5"
title
string
Condition name.
active
boolean
Indicates whether the condition type is active.
definitions
EnhancedConditionDefinitionContract
Definitions provided by the EnhancedConditionDefinitionContract.
categoryDefinitions
OptionDefinitionContract
Category details provided by the OptionDefinitionContract.
createdBy
EntityReferenceContract
Information about the user who created the condition type. Retrieve only.
createdDate
string
The date on which the condition type was created. The format is yyyy-MM-ddTHH:mm:ssZ. Retrieve only.
lastModifiedBy
EntityReferenceContract
Information about the user who last modified the condition type. Retrieve only.
lastModifiedDate
string
The date the condition type was last modified. The format is yyyy-MM-ddTHH:mm:ssZ. Retrieve only.

Enhanced Condition Definition Contract Attributes

The following objects and attributes make up the EnhancedConditionDefinitionContract object.

ATTRIBUTEDESCRIPTION
categoryDefinitions
Array[OptionDefinitionContract]
List of the Category field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
priorToDefinitions
Array[OptionDefinitionContract]
List of the Prior To field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
recipientDefinitions
Array[OptionDefinitionContract]
List of the Recipient field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
sourceDefinitions
Array[OptionDefinitionContract]
List of the Source field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
trackingDefinitions
Array[TrackingDefinitionContract]
List of the Status Tracking definitions for this condition type, condition template, or condition. This field only applies to Enhanced Conditions.
See the TrackingDefinitionContract.

Tracking Definition Contract Attributes

The following objects and attributes make up the TrackingDefinitionContract object.

ATTRIBUTEDESCRIPTION
name
string
Name of tracking definition.
open
boolean
Indicates whether the condition is still open (and not considered closed) when the specific tracking option is selected in the loan file.
roles
Array[EntityReferenceContract]
EntityReferenceContract describing roles.

Enhanced Condition Set Contract Attributes

The following objects and attributes make up the enhancedConditionSetContract object.

ATTRIBUTEDESCRIPTION
id
string
Unique identifier of the condition, which is guaranteed to be unique.
name
string
Name of the enhanced condition set.
description
string
Description of the enhanced condition set.
conditions
object
Object containing details about each enhanced condition.
conditions.id
string
Unique identifier of the condition, which is guaranteed to be unique. For example:
"3AA5BF62-3C0D-46A7-8ADE-03907BE0A5E5"
When you specify a condition in a call, you provide the condition ID. The condition ID can be retrieved from the response header when the condition is created.
conditions.title
string
Title or name of the condition. For example, "Income - Personal Tax Returns".
conditions.conditionType
string
Identifies the type of condition. For example, Preliminary, Underwriting, Post-Closing, etc. The value is obtained from the Enhanced Condition template.
conditions.active
boolean
Indicates whether the condition is active.
conditions.internalId
string
The internal identifier of the condition that will be displayed to Encompass Web users. Alphanumeric, no special characters. For example, "INC0001".
conditions.internalDescription
string
The internal description of the condition that will be displayed to Encompass Web users. For example, "Collect signed and dated returns with all pages and schedules".
conditions.externalId
string
The external identifier of the condition that will be displayed to TPO Users. Should be alphanumeric, no special characters to be allowed.
conditions.externalDescription
string
The external description of the condition that will be displayed to TPO users. For example, "Provide signed and dated tax returns with all pages and schedules."
conditions.category
string
Identifies the category associated with the condition. Values are defined within Encompass settings and can vary between lenders and investors.
Some example values are:

Assets
Credit
Income
Legal
Misc
Property
conditions.priorTo
string
Identifies when the condition is required to be cleared or waived. Values are defined within Encompass settings and can vary between lenders and investors. Example values are:

Approval
Docs
Funding
Closing
* Purchase
conditions.daysToReceive Number of days the condition is expected to be received.
conditions.customizeTypeDefinition
boolean
Indicates whether the condition set type is customized.
conditions.printDefinitions
Array of strings
Indicates whether the condition should be printed on internal and/ or external documents.
Possible values: "InternalPrint", "ExternalPrint"
conditions.createdDate Date and time the condition was created. For example, 2022-01-24T22:11:53.733Z
conditions.createdBy
entityReferenceContract
The Entity Reference contract describing the user or role who created the condition or document.
conditions.lastModifiedDate Date and time the condition was last modified. For example, 2022-01-24T22:11:53.733Z
conditions.lastModifiedBy
EntityReferenceContract
Information about the last modification made to the condition.

Enhanced Condition Template Contract Attributes

The following objects and attributes make up the enhancedConditionTemplateContract object.

ATTRIBUTEDESCRIPTION
id
string
Unique identifier of the condition. For example:
"3AA5BF62-3C0D-46A7-8ADE-03907BE0A5E5"
title
string
Condition name.
conditionType
string
Identifies the type of condition. For example, Preliminary, Underwriting, Post-Closing, etc. The value is obtained from the Enhanced Condition template.
active
boolean
Indicates whether the condition type is active.
internalId
string
The internal identifier of the condition that will be displayed to Encompass Web users. Alphanumeric, no special characters. For example, "INC0001".
internalDescription
string
The internal description of the condition that will be displayed to Encompass Web users. For example, "Collect signed and dated returns with all pages and schedules".
externalId
string
The external identifier of the condition that will be displayed to TPO Users. Should be alphanumeric, no special characters to be allowed.
externalDescription
string
The external description of the condition that will be displayed to TPO users. For example, "Provide signed and dated tax returns with all pages and schedules."
category
string
Identifies the category associated with the condition. Values are defined within Encompass settings and can vary between lenders and investors.
Some example values are:

Assets
Credit
Income
Legal
Misc
Property
priorTo
string
Identifies when the condition is required to be cleared or waived. Values are defined within Encompass settings and can vary between lenders and investors. Example values are:

Approval
Docs
Funding
Closing
* Purchase
daysToReceive
integer
Number of days the condition is expected to be received.
customizeTypeDefinition
boolean
Indicates whether the condition type is customized.
printDefinitions
Array of strings
Indicates whether the condition should be printed on internal and/ or external documents.
Possible values: "InternalPrint", "ExternalPrint"
allowDuplicate
boolean
Indicates whether conditions can be duplicated in the loan.
recipient
string
Recipient of the condition. For example, "MERS".
Values are defined within Encompass settings and can vary between lenders and investors.
source
string
The source the condition may come from.
startDate
string
Identifies the date the condition takes effect. For example, 2022-01-20T16:43:41.645Z
endDate
string
Identifies the date that the condition is no longer required. For example, 2022-01-20T16:43:41.645Z
customDefinitions
EnhancedConditionDefinitionContract
Custom definitions for the condition type.
createdDate
string
Date and time the condition was created. For example, 2022-01-20T16:43:41.655Z.
createdBy
EntityReferenceContract
The Entity Reference contract describing the user or role who created the condition or document.
lastModifiedDate
string
RetrieveOnly. Date and time the condition was last modified. For example, 2022-01-20T16:43:41.655Z.
lastModifiedBy
EntityReferenceContract
RetrieveOnly. Information about the last modification made to the condition.

Custom Definitions Contract Attributes

The following attributes make up the customDefinitions object which contains attributes that describe custom definitions for the condition type.

ATTRIBUTEDESCRIPTION
categoryDefinitions
Array[OptionDefinitionContract]
List of the Category field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
priorToDefinitions
Array[OptionDefinitionContract]
List of the Prior To field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
recipientDefinitions
Array[OptionDefinitionContract]
List of the Recipient field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
sourceDefinitions
Array[OptionDefinitionContract]
List of the Source field options for this condition type, condition template, or condition. This field only applies to Enhanced Conditions. See the OptionDefinitionContract.
trackingDefinitions
Array[TrackingDefinitionContract]
List of the Status Tracking definitions for this condition type, condition template, or condition. This field only applies to Enhanced Conditions.
See the TrackingDefinitionContract.

Connect Settings Contract Attributes

The following attributes make up the connectSettings object which contains attributes that describe the TPO Connect settings for the condition template.

ATTRIBUTEDESCRIPTION
documentTemplate
EntityReferenceContract
Reference to the document template if the documentType is Template.
documentOption
string
Indicates if documents should be created using a predefined document template or just with a matching name of the condition.

Option Definition Contract Attributes

The following objects and attributes make up the OptionDefinitionContract object.

ATTRIBUTEDESCRIPTION
name
string
Name of the option that will be displayed in the list or drop-down. For example, "Fulfilled"