checkApplicantEligibility

Mutation

Run underwriting on a credit report and generate an underwriting document listing eligible and ineligible debts.

Mutation Signature

mutation {
  checkApplicantEligibility(applicationType: ApplicationTypeInput!, input: UwResultCheckInput!): EligibilityResponse!
}

Example Request

GraphQL

mutation CheckApplicantEligibility($applicationType: ApplicationTypeInput!, $input: UwResultCheckInput!) {
  checkApplicantEligibility(applicationType: $applicationType, input: $input) {
    # Add fields you want to retrieve
  }
}

Example Variables:

{
  "applicationType": "SINGLE",
  "input": {
    "primaryReportId": "cr-abc123def456",
    "leadId": "lead-67890",
    "applicantContactInfo": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "phone": "+12135551234",
      "applicantState": "CA",
      "ssn": "123456789",
      "dob": "1985-03-15",
      "homeAddress": "123 Main Street, Los Angeles, CA 90001",
      "hardship": "Significant decrease in income",
      "eligibilityReqMilitary": "NO",
      "eligibilityReqCreditCounselling": "NO",
      "eligibilityReqBankruptcy": "NO",
      "eligibilityReqFederalGovDebt": "NO",
      "eligibilityReqSecuredDebt": "NO"
    },
    "agentAssigned": "agent-12345",
    "budget": {
      "totalMonthlyIncome": 5000,
      "totalMonthlyExpense": 3500
    }
  }
}

Apollo Studio

Open in Apollo Studio Explorer →

Click the link above to open this mutation in Apollo Studio Explorer with the query pre-filled. You’ll need to authenticate with your sandbox credentials.

Example Response

{
  "data": {
    "checkApplicantEligibility": {
      "data": {
        "id": "uw-xyz789",
        "revision": 1,
        "applicationUwResult": {
          "applicantPrequalified": true,
          "applicationType": "SINGLE",
          "totalDebt": 25000,
          "totalEligibleDebt": 22500,
          "rootFilters": {
            "totalDebtValueCheck": true,
            "tenPercentRuleCheck": true,
            "agentAssignedCheck": true,
            "creditReport30DaysCheck": true,
            "psStateServiceCheck": true,
            "programTermCheck": true,
            "budgetHardshipCheck": true
          }
        },
        "applicantUwResult": {
          "id": "uw-xyz789",
          "creditReportId": "cr-abc123def456",
          "leadId": "lead-67890",
          "applicationType": "SINGLE",
          "creditReportSource": "CRS_EQUIFAX",
          "rootFilters": {
            "stateServiceCheck": true,
            "bankruptcyCheck": true,
            "ssnCheck": true,
            "dobCheck": true,
            "phoneCheck": true,
            "firstNameCheck": true,
            "lastNameCheck": true,
            "hardshipCheck": true
          },
          "debts": [
            {
              "id": "debt-001",
              "creditorName": "Capital One",
              "accountNumber": "****1234",
              "currentBalance": 5432.1,
              "isSelected": true,
              "eligibilityStatus": "ELIGIBLE",
              "approvedAccountTypeCheck": true,
              "unacceptableCreditorCheck": true,
              "minimumDebtValueCheck": true
            },
            {
              "id": "debt-002",
              "creditorName": "Chase Bank",
              "accountNumber": "****5678",
              "currentBalance": 12500,
              "isSelected": true,
              "eligibilityStatus": "ELIGIBLE",
              "approvedAccountTypeCheck": true,
              "unacceptableCreditorCheck": true,
              "minimumDebtValueCheck": true
            }
          ]
        },
        "maxTerm": 48,
        "createdAt": "2025-01-15T10:30:00.000Z"
      },
      "errors": null
    }
  }
}

Arguments

Argument	Type	Description
applicationType	ApplicationTypeInput!	Application type for underwriting
input	UwResultCheckInput!	Input for checking applicant eligibility. Contains credit report IDs, contact information, and enrollment details.

Input Types

ApplicationTypeInput

Application type for underwriting

Value	Description
JOINT	Joint application with primary applicant and co-applicant
SINGLE	Single applicant application

UwResultCheckInput

Input for checking applicant eligibility. Contains credit report IDs, contact information, and enrollment details.

Required Fields:

Field	Type	Description
primaryReportId	String!	Applicant normalized credit report ID from the credit report service
applicantContactInfo	ApplicantContactInfoInput!	Applicant contact information

Optional Fields:

Field	Type	Description
secondaryReportId	String	Co-Applicant normalized credit report ID from the credit report service
leadId	String	Applicant leadId set by the integrating CRM to identify the lead in its system.
coApplicantContactInfo	ApplicantContactInfoInput	Co-applicant contact information. Required for JOINT application.
agentAssigned	String	Agent userId set by the integrating CRM to identify the agent in its system.
plan	PlanInput	Enrollment payment plan
budget	BudgetInput	Budget
additionalInfo	AdditionalInfoInput	Additional underwriting configuration options

ApplicantContactInfoInput

Applicant contact and personal information for eligibility check

Required Fields:

Field	Type	Description
applicantState	String!	Applicant state. Must be a valid U.S. state. Sample Values: - AL - AK - AZ - AR - CA - CO

Optional Fields:

Field	Type	Description
employerName	String	Employer name
isMarriedToCoApplicant	Boolean	Identify if the applicant is married to the co-applicant. Values: - true - false
homeAddress	String	Applicant home address
ssn	String	Applicant SSN must be 9 digits long. Ex:000000000.
dob	String	Applicant date of birth must be in the format YYYY-MM-DD.
phone	String	Applicant phone number must be U.S. phone number in E.164 format.
cellPhone	String	Applicant cell phone number must be U.S. phone number in E.164 format.
firstName	String	Applicant first name must be 2-20 characters long.
lastName	String	Applicant last name must be 2-20 characters long.
jobTitle	String	Applicant job title must be 2-20 characters long.
email	String	Applicant email must be a valid email address.
hardship	String	Applicant hardship reason. Sample Values: - Significant decrease in income. - Loss of employment. - Significant medical expenses.
filedBankruptcy	String	Has the applicant filed bankruptcy. Values: - YES - NO
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name
bankAccountType	String	Applicant bank account type
eligibilityReqMilitary	String	An answer must be provided for Question: Are you in the military, work in law enforcement, work for a Financial institution or have security clearance? Values: - YES - NO
eligibilityReqCreditCounselling	String	An answer must be provided for Question: Are you currently enrolled in a credit counseling program? Values: - YES - NO
eligibilityReqBankruptcy	String	An answer must be provided for Question: Are you currently involved in a Bankruptcy proceeding? Values: - YES - NO
eligibilityReqFederalGovDebt	String	An answer must be provided for Question: Are any of the accounts being submitted for enrollment backed by the U.S. Federal government? Values: - YES - NO
eligibilityReqSecuredDebt	String	An answer must be provided for Question: Are any of the accounts being submitted for enrollment secured by any type of collateral? Values: - YES - NO
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfoInput

Applicant contact and personal information for eligibility check

Required Fields:

Field	Type	Description
applicantState	String!	Applicant state. Must be a valid U.S. state. Sample Values: - AL - AK - AZ - AR - CA - CO

Optional Fields:

Field	Type	Description
employerName	String	Employer name
isMarriedToCoApplicant	Boolean	Identify if the applicant is married to the co-applicant. Values: - true - false
homeAddress	String	Applicant home address
ssn	String	Applicant SSN must be 9 digits long. Ex:000000000.
dob	String	Applicant date of birth must be in the format YYYY-MM-DD.
phone	String	Applicant phone number must be U.S. phone number in E.164 format.
cellPhone	String	Applicant cell phone number must be U.S. phone number in E.164 format.
firstName	String	Applicant first name must be 2-20 characters long.
lastName	String	Applicant last name must be 2-20 characters long.
jobTitle	String	Applicant job title must be 2-20 characters long.
email	String	Applicant email must be a valid email address.
hardship	String	Applicant hardship reason. Sample Values: - Significant decrease in income. - Loss of employment. - Significant medical expenses.
filedBankruptcy	String	Has the applicant filed bankruptcy. Values: - YES - NO
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name
bankAccountType	String	Applicant bank account type
eligibilityReqMilitary	String	An answer must be provided for Question: Are you in the military, work in law enforcement, work for a Financial institution or have security clearance? Values: - YES - NO
eligibilityReqCreditCounselling	String	An answer must be provided for Question: Are you currently enrolled in a credit counseling program? Values: - YES - NO
eligibilityReqBankruptcy	String	An answer must be provided for Question: Are you currently involved in a Bankruptcy proceeding? Values: - YES - NO
eligibilityReqFederalGovDebt	String	An answer must be provided for Question: Are any of the accounts being submitted for enrollment backed by the U.S. Federal government? Values: - YES - NO
eligibilityReqSecuredDebt	String	An answer must be provided for Question: Are any of the accounts being submitted for enrollment secured by any type of collateral? Values: - YES - NO
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

PlanInput

Enrollment payment plan configuration

Optional Fields:

Field	Type	Description
frequency	String	Payment frequency. Ex: Monthly, Bi-Weekly
firstPaymentAmount	Float	First payment amount. Ex: 100, 123.45,
secondPaymentAmount	Float	Second payment amount. Ex: 100, 123.45,
firstPaymentDate	String	First payment date.
firstDraftException	String	First draft exception.
programTerm	Int	Program term.
feePercentage	Float	Fee percentage. Ex: 27
epfReduction	String	EPF reduction. Ex: YES, NO
secondPaymentDate	String	Second payment date.
planId	String	Enrollment plan ID.

BudgetInput

Applicant budget information for affordability calculations

Optional Fields:

Field	Type	Description
totalMonthlyIncome	Float	Total monthly income.
totalMonthlyExpense	Float	Total monthly expenses.

AdditionalInfoInput

Additional underwriting configuration options and exceptions

Optional Fields:

Field	Type	Description
debtAmountException	String	Debt amount exception
includeUnacceptableCreditor	Boolean	Include unacceptable creditor
termExtensionException	Float	Term extension exception value
standaloneDebtsException	Boolean	Standalone debts exception
eomFirstDraftDateException	Boolean	EOM first draft date exception

Response Type

Returns: EligibilityResponse!

EligibilityResponse

Response from eligibility check or update operations

Field	Type	Description
data	UwEligibilityResult	The underwriting eligibility result data
errors	[EligibilityResponseError]	List of errors or warnings from underwriting checks

UwEligibilityResult

Field	Type	Description
id	ID!	Underwriting document ID
revision	Int!	Revision number of this underwriting document. Each time the document is edited the revision number is incremented
applicationUwResult	ApplicationUwResult	Underwriting result for the application as a whole.
applicantUwResult	UwResult	Applicant’s debts (tradeline) specific underwriting results
coApplicantUwResult	UwResult	Co-applicant’s debts (tradeline) specific underwriting results. Only applicable to JOINT application.
jointUwResult	JointUwResult	Joint debts (tradeline) specific underwriting results. Only applicable to JOINT application.
tradelineMetadata	TradelineMetadata	Additional metadata about UW application
maxTerm	Int	Maximum term (in months) calculated for this underwriting application
createdAt	Date	Date and time this underwriting document revision was created

ApplicationUwResult

Field	Type	Description
applicantPrequalified	Boolean!	True/False flag to identify if this application passed all underwriting criteria
applicationType	String	Type of application can be SINGLE or JOINT
rootFilters	ApplicationRootFilters!	Application level filters
totalDebt	Float	Total selected debts balance
totalEligibleDebt	Float	Total eligible and selected debts balance
tradelineMetadata	TradelineMetadata	Additional metadata about UW application

ApplicationRootFilters

Field	Type	Description
totalDebtValueCheck	Boolean	True/False flag to identify if this underwriting check passed
tenPercentRuleCheck	Boolean	True/False flag to identify if this underwriting check passed
agentAssignedCheck	Boolean	True/False flag to identify if this underwriting check passed
creditReport30DaysCheck	Boolean	True/False flag to identify if this underwriting check passed
psStateServiceCheck	Boolean	True/False flag to identify if this underwriting check passed
uniqueEmailPhoneCheck	Boolean	True/False flag to identify if this underwriting check passed
programTermCheck	Boolean	True/False flag to identify if this underwriting check passed
budgetHardshipCheck	Boolean	True/False flag to identify if this underwriting check passed

TradelineMetadata

Field	Type	Description
enrolledUpstartDebtAccountNumbers	[String]	List of externalDebtsId’s that belong to selected Upstart debts, if empty then none
enrolledCapitalOneDebtAccountNumbers	[String]	List of externalDebtsId’s that belong to selected Catipal One debts, if empty then none
enrolledDiscoverDebtAccountNumbers	[String]	List of externalDebtsId’s that belong to selected Discover debts, if empty then none

UwResult

Field	Type	Description
id	ID!	Underwriting document ID
uwOrgId	String	The organization underwriting rules used for this application. Values: - ALV - GLG
reqOrgId	String	Requesting organization ID. Based on the credentials of the system making the request.
revision	Int!	Document revision number. Each time the document is edited the revision number is incremented
reqOrgContactId	String	Requesting organization contact ID
creditReportId	String	Applicant normalized credit report ID from the credit report service
coCreditReportId	String	Co-Applicant normalized credit report ID from the credit report service
leadId	String	Applicant leadId set by the integrating CRM to identify the lead in its system.
applicationType	String	Type of application can be SINGLE or JOINT
applicantInfo	ApplicantInfo!	Applicant information.
rootFilters	ApplicantRootFilters!	Root level filters (All underwriting filters that are not specific to a debt)
debts	[UwResultDebt]!	List of debts. Each debt will have additional underwriting pass/fail information
creditReportSource	String!	Credit report source Values: - SPINWHEEL - CRS_TRANSUNION - CRS_EQUIFAX
rootHistory	[UwResultHistory]	Audit history of edits applied to the top level fields of this application
createdAt	Date	Date and time this underwriting document revision was created

ApplicantInfo

Field	Type	Description
publicRecords	[PublicRecord]	Public records from the credit report.
applicantContactInfo	ApplicantContactInfo	Applicant’s contact information
coApplicantContactInfo	ApplicantContactInfo	Co-applicant’s contact information
agentAssigned	String	Agent userId set by the integrating CRM to identify the agent in its system.
plan	Plan	Enrollment plan.
budget	Budget	Budget.
additionalInfo	AdditionalInfo	Additional info

PublicRecord

Public Record

Field	Type	Description
bankruptcyCode	String!	Bankcrupty code
bankruptcyDateFiled	String	Bankcrupty date filed
bankruptcyDispositionType	String	Bankcrupty disposition type

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

Plan

Field	Type	Description
frequency	String	Frequency of the enrollment plan. Ex: Monthly, Bi-Weekly
firstPaymentAmount	Float	First payment amount. Ex: 100, 123.45,
secondPaymentAmount	Float	Second payment amount. Ex: 100, 123.45,
firstPaymentDate	String	First payment date.
secondPaymentDate	String	Second payment date.
firstDraftException	String	First draft exception.
programTerm	Int	Program term.
feePercentage	Float	Fee percentage.
epfReduction	String	EPF reduction. Ex: YES, NO
planId	String	Enrollment plan ID.

Budget

Field	Type	Description
totalMonthlyIncome	Float	Total monthly income.
totalMonthlyExpense	Float	Total monthly expenses.

AdditionalInfo

Field	Type	Description
debtAmountException	String	Debt amount exception
includeUnacceptableCreditor	Boolean	Include unacceptable creditor
termExtensionException	Float	Term extension exception value
standaloneDebtsException	Boolean	Standalone debts exception
eomFirstDraftDateException	Boolean	EOM first draft date exception

ApplicantRootFilters

Field	Type	Description
stateServiceCheck	Boolean	True/False flag to identify if this underwriting check passed
bankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
ssnCheck	Boolean	True/False flag to identify if this underwriting check passed
dobCheck	Boolean	True/False flag to identify if this underwriting check passed
phoneCheck	Boolean	True/False flag to identify if this underwriting check passed
firstNameCheck	Boolean	True/False flag to identify if this underwriting check passed
lastNameCheck	Boolean	True/False flag to identify if this underwriting check passed
applicantEmployerCheck	Boolean	True/False flag to identify if this underwriting check passed
jobTitleCheck	Boolean	True/False flag to identify if this underwriting check passed
addressCheck	Boolean	True/False flag to identify if this underwriting check passed
emailCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantFirstNameCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantLastNameCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantEmployerCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantJobTitleCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantSsnCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantDobCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantPhoneCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantCellPhoneCheck	Boolean	True/False flag to identify if this underwriting check passed
hardshipCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateSsnCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateCoApplicantSsnCheck	Boolean	True/False flag to identify if this underwriting check passed
routingNumberCheck	Boolean	True/False flag to identify if this underwriting check passed
bankNameCheck	Boolean	True/False flag to identify if this underwriting check passed
bankAccountNumberCheck	Boolean	True/False flag to identify if this underwriting check passed
bankAccountHolderNameCheck	Boolean	True/False flag to identify if this underwriting check passed
bankAccountTypeCheck	Boolean	True/False flag to identify if this underwriting check passed
debtsBackedByUsFedGovCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqMilitaryCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqCreditCounsellingCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqBankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqFederalGovDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqSecuredDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
frequencyMinimumPaymentCheck	Boolean	True/False flag to identify if this underwriting check passed
budgetAffordabilityCheck	Boolean	True/False flag to identify if this underwriting check passed
firstDraftDateCheck	Boolean	True/False flag to identify if this underwriting check passed
feeValidationCheck	Boolean	True/False flag to identify if this underwriting check passed
secondDraftDateCheck	Boolean	True/False flag to identify if this underwriting check passed
companyIsAuthorizedCheck	Boolean	True/False flag to identify if this underwriting check passed
enrollmentPlanCheck	Boolean	True/False flag to identify if this underwriting check passed
termExtensionExceptionCheck	Boolean	True/False flag to identify if this underwriting check passed
caStateFileCheck	Boolean	True/False flag to identify if the co-applicant has ssn when state is CA and application type is JOINT

UwResultDebt

Debt information with underwriting check results

Field	Type	Description
id	ID!	Unique identifier for the debt
applicantId	String	Primary applicant ID
coApplicantId	String	Secondary applicant ID, if applicable (For JOINT application only)
externalDebtId	ID	This is replaced by accountNumber @deprecated Use accountNumber instead
accountNumber	String	Debt account number
externalCrmId	String	Optional field to identify the debt in the requesting CRM
isSelected	Boolean!	True/False flag to identify if this debt is selected for program enrollment
coApplicantIsSelected	Boolean	Only applicable to JOINT debt. True/False flag to identify if this debt is selected by the co-applicant
eligibilityStatus	EligibilityStatus!	Identify the eligibility status
isOverridden	Boolean	True/False flag to identify if the eligiblity status is being overriden
exceptions	[String]	List of reasons the eligibility status is being overridden
history	[UwResultDebtHistory]	History of all the updates made to this debt
source	String!	Source of the debt entry can be MANUAL or CREDIT_REPORT
creditorName	String	creditor name
parentCreditorName	String	Parent creditor name
parentCreditorId	String	Parent creditor ID
originalCreditorName	String	Original creditor name
creditorId	ID	Creditor ID from Forth
creditorType	String	creditor type
ecoaCode	String	ECOA Code
accountType	String	Account type
portfolioType	String	Portfolio type
debtType	String	Debt type
openDate	String	Date debt was opened
lastPaymentDate	String	Date of the last payment
hasLastPayment	Boolean	True/False flag to identify if last payment was amde
narrativeCodes	[String]	Narrative codes that might include bankcruptcy codes
bankruptcyDateFiled	String	Bankruptcy Record Date. This come from the credit report and does not need to be updated.
currentBalance	Float	Current debt balance
originalBalance	Float	Original debt balance
nawSignedDate	Date	Only applicable to JOINT debt. The date when the non-applicant waiver has been signed.
nawUrl	String	Only applicable to JOINT debt. The url to the non-applicant waiver document’s file
hasProofOfLiability	Boolean	Has provided proof of liability
forthDebtTypeId	String	Forth Debt Type ID
remarks	[String]	Remarks
isCollection	Boolean	Flag to show if the debt is in collection
approvedAccountTypeCheck	Boolean	True/False flag to identify if this underwriting check passed
unacceptableCreditorCheck	Boolean	True/False flag to identify if this underwriting check passed
creditUnionAndStateCheck	Boolean	True/False flag to identify if this underwriting check passed
debtOwnershipCheck	Boolean	True/False flag to identify if this underwriting check passed
minimumDebtValueCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateDebtsCheck	Boolean	True/False flag to identify if this debt is selected and a duplicate debt
multipleCreditUnionCheck	Boolean	True/False flag to identify if this underwriting check passed
paymentHistoryCheck	Boolean	True/False flag to identify if this underwriting check passed
unsecuredDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
bankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
employerIsCreditorCheck	Boolean	True/False flag to identify if the creditor is the same as employer
standaloneDebtsCheck	Boolean	True/False flag to identify if the creditor is a standalone debt
coApplicantCheck	Boolean	Only applicable to JOINT debt. True/False flag to identify if this underwriting check passed
currAndOgBalanceCheck	Boolean	Current and original balance check
proofOfLiabilityCheck	Boolean	Proof of liability
delinquency	String	account rating /delinquency value
monthlyPayment	Float	Monthly payment
notes	[String]	Debt Notes

UwResultDebtHistory

Historical record of changes made to a debt

Field	Type	Description
isSelected	Boolean	Whether the debt was selected for enrollment at this revision
coApplicantIsSelected	Boolean	Whether the co-applicant had selected this debt at this revision
exceptions	[String]	Exceptions applied to the debt at this revision
source	String	Source of the debt (MANUAL or CREDIT_REPORT)
creditorName	String	Creditor name at this revision
originalCreditorName	String	Original creditor name at this revision
creditorType	String	Creditor type at this revision
ecoaCode	String	ECOA code at this revision
accountType	String	Account type at this revision
portfolioType	String	Portfolio type at this revision
debtType	String	Debt type at this revision
openDate	String	Open date at this revision
lastPaymentDate	String	Last payment date at this revision
hasLastPayment	Boolean	Whether last payment was made at this revision
currentBalance	Float	Current balance at this revision
originalBalance	Float	Original balance at this revision
narrativeCodes	[String]	Narrative codes at this revision
bankruptcyDateFiled	String	Bankruptcy date filed at this revision
nawSignedDate	Date	Non-applicant waiver signed date at this revision
nawUrl	String	Non-applicant waiver URL at this revision
hasProofOfLiability	Boolean	Whether proof of liability was provided at this revision
isCollection	Boolean	Whether the debt was in collection at this revision
remarks	[String]	Remarks at this revision
monthlyPayment	Float	Monthly payment at this revision
updatedBy	ID	User ID who made this update
fromRevision	Int	The revision number this history entry was created from

UwResultHistory

Historical record of changes made to the underwriting result

Field	Type	Description
applicantInfo	ApplicantInfo	Applicant information at this revision
leadId	String	Lead ID at this revision
updatedBy	ID	User ID who made this update
fromRevision	Int	The revision number this history entry was created from

ApplicantInfo

Field	Type	Description
publicRecords	[PublicRecord]	Public records from the credit report.
applicantContactInfo	ApplicantContactInfo	Applicant’s contact information
coApplicantContactInfo	ApplicantContactInfo	Co-applicant’s contact information
agentAssigned	String	Agent userId set by the integrating CRM to identify the agent in its system.
plan	Plan	Enrollment plan.
budget	Budget	Budget.
additionalInfo	AdditionalInfo	Additional info

PublicRecord

Public Record

Field	Type	Description
bankruptcyCode	String!	Bankcrupty code
bankruptcyDateFiled	String	Bankcrupty date filed
bankruptcyDispositionType	String	Bankcrupty disposition type

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

Plan

Field	Type	Description
frequency	String	Frequency of the enrollment plan. Ex: Monthly, Bi-Weekly
firstPaymentAmount	Float	First payment amount. Ex: 100, 123.45,
secondPaymentAmount	Float	Second payment amount. Ex: 100, 123.45,
firstPaymentDate	String	First payment date.
secondPaymentDate	String	Second payment date.
firstDraftException	String	First draft exception.
programTerm	Int	Program term.
feePercentage	Float	Fee percentage.
epfReduction	String	EPF reduction. Ex: YES, NO
planId	String	Enrollment plan ID.

Budget

Field	Type	Description
totalMonthlyIncome	Float	Total monthly income.
totalMonthlyExpense	Float	Total monthly expenses.

AdditionalInfo

Field	Type	Description
debtAmountException	String	Debt amount exception
includeUnacceptableCreditor	Boolean	Include unacceptable creditor
termExtensionException	Float	Term extension exception value
standaloneDebtsException	Boolean	Standalone debts exception
eomFirstDraftDateException	Boolean	EOM first draft date exception

UwResult

Field	Type	Description
id	ID!	Underwriting document ID
uwOrgId	String	The organization underwriting rules used for this application. Values: - ALV - GLG
reqOrgId	String	Requesting organization ID. Based on the credentials of the system making the request.
revision	Int!	Document revision number. Each time the document is edited the revision number is incremented
reqOrgContactId	String	Requesting organization contact ID
creditReportId	String	Applicant normalized credit report ID from the credit report service
coCreditReportId	String	Co-Applicant normalized credit report ID from the credit report service
leadId	String	Applicant leadId set by the integrating CRM to identify the lead in its system.
applicationType	String	Type of application can be SINGLE or JOINT
applicantInfo	ApplicantInfo!	Applicant information.
rootFilters	ApplicantRootFilters!	Root level filters (All underwriting filters that are not specific to a debt)
debts	[UwResultDebt]!	List of debts. Each debt will have additional underwriting pass/fail information
creditReportSource	String!	Credit report source Values: - SPINWHEEL - CRS_TRANSUNION - CRS_EQUIFAX
rootHistory	[UwResultHistory]	Audit history of edits applied to the top level fields of this application
createdAt	Date	Date and time this underwriting document revision was created

ApplicantInfo

Field	Type	Description
publicRecords	[PublicRecord]	Public records from the credit report.
applicantContactInfo	ApplicantContactInfo	Applicant’s contact information
coApplicantContactInfo	ApplicantContactInfo	Co-applicant’s contact information
agentAssigned	String	Agent userId set by the integrating CRM to identify the agent in its system.
plan	Plan	Enrollment plan.
budget	Budget	Budget.
additionalInfo	AdditionalInfo	Additional info

PublicRecord

Public Record

Field	Type	Description
bankruptcyCode	String!	Bankcrupty code
bankruptcyDateFiled	String	Bankcrupty date filed
bankruptcyDispositionType	String	Bankcrupty disposition type

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

Plan

Field	Type	Description
frequency	String	Frequency of the enrollment plan. Ex: Monthly, Bi-Weekly
firstPaymentAmount	Float	First payment amount. Ex: 100, 123.45,
secondPaymentAmount	Float	Second payment amount. Ex: 100, 123.45,
firstPaymentDate	String	First payment date.
secondPaymentDate	String	Second payment date.
firstDraftException	String	First draft exception.
programTerm	Int	Program term.
feePercentage	Float	Fee percentage.
epfReduction	String	EPF reduction. Ex: YES, NO
planId	String	Enrollment plan ID.

Budget

Field	Type	Description
totalMonthlyIncome	Float	Total monthly income.
totalMonthlyExpense	Float	Total monthly expenses.

AdditionalInfo

Field	Type	Description
debtAmountException	String	Debt amount exception
includeUnacceptableCreditor	Boolean	Include unacceptable creditor
termExtensionException	Float	Term extension exception value
standaloneDebtsException	Boolean	Standalone debts exception
eomFirstDraftDateException	Boolean	EOM first draft date exception

ApplicantRootFilters

Field	Type	Description
stateServiceCheck	Boolean	True/False flag to identify if this underwriting check passed
bankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
ssnCheck	Boolean	True/False flag to identify if this underwriting check passed
dobCheck	Boolean	True/False flag to identify if this underwriting check passed
phoneCheck	Boolean	True/False flag to identify if this underwriting check passed
firstNameCheck	Boolean	True/False flag to identify if this underwriting check passed
lastNameCheck	Boolean	True/False flag to identify if this underwriting check passed
applicantEmployerCheck	Boolean	True/False flag to identify if this underwriting check passed
jobTitleCheck	Boolean	True/False flag to identify if this underwriting check passed
addressCheck	Boolean	True/False flag to identify if this underwriting check passed
emailCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantFirstNameCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantLastNameCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantEmployerCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantJobTitleCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantSsnCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantDobCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantPhoneCheck	Boolean	True/False flag to identify if this underwriting check passed
coApplicantCellPhoneCheck	Boolean	True/False flag to identify if this underwriting check passed
hardshipCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateSsnCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateCoApplicantSsnCheck	Boolean	True/False flag to identify if this underwriting check passed
routingNumberCheck	Boolean	True/False flag to identify if this underwriting check passed
bankNameCheck	Boolean	True/False flag to identify if this underwriting check passed
bankAccountNumberCheck	Boolean	True/False flag to identify if this underwriting check passed
bankAccountHolderNameCheck	Boolean	True/False flag to identify if this underwriting check passed
bankAccountTypeCheck	Boolean	True/False flag to identify if this underwriting check passed
debtsBackedByUsFedGovCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqMilitaryCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqCreditCounsellingCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqBankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqFederalGovDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
eligibilityReqSecuredDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
frequencyMinimumPaymentCheck	Boolean	True/False flag to identify if this underwriting check passed
budgetAffordabilityCheck	Boolean	True/False flag to identify if this underwriting check passed
firstDraftDateCheck	Boolean	True/False flag to identify if this underwriting check passed
feeValidationCheck	Boolean	True/False flag to identify if this underwriting check passed
secondDraftDateCheck	Boolean	True/False flag to identify if this underwriting check passed
companyIsAuthorizedCheck	Boolean	True/False flag to identify if this underwriting check passed
enrollmentPlanCheck	Boolean	True/False flag to identify if this underwriting check passed
termExtensionExceptionCheck	Boolean	True/False flag to identify if this underwriting check passed
caStateFileCheck	Boolean	True/False flag to identify if the co-applicant has ssn when state is CA and application type is JOINT

UwResultDebt

Debt information with underwriting check results

Field	Type	Description
id	ID!	Unique identifier for the debt
applicantId	String	Primary applicant ID
coApplicantId	String	Secondary applicant ID, if applicable (For JOINT application only)
externalDebtId	ID	This is replaced by accountNumber @deprecated Use accountNumber instead
accountNumber	String	Debt account number
externalCrmId	String	Optional field to identify the debt in the requesting CRM
isSelected	Boolean!	True/False flag to identify if this debt is selected for program enrollment
coApplicantIsSelected	Boolean	Only applicable to JOINT debt. True/False flag to identify if this debt is selected by the co-applicant
eligibilityStatus	EligibilityStatus!	Identify the eligibility status
isOverridden	Boolean	True/False flag to identify if the eligiblity status is being overriden
exceptions	[String]	List of reasons the eligibility status is being overridden
history	[UwResultDebtHistory]	History of all the updates made to this debt
source	String!	Source of the debt entry can be MANUAL or CREDIT_REPORT
creditorName	String	creditor name
parentCreditorName	String	Parent creditor name
parentCreditorId	String	Parent creditor ID
originalCreditorName	String	Original creditor name
creditorId	ID	Creditor ID from Forth
creditorType	String	creditor type
ecoaCode	String	ECOA Code
accountType	String	Account type
portfolioType	String	Portfolio type
debtType	String	Debt type
openDate	String	Date debt was opened
lastPaymentDate	String	Date of the last payment
hasLastPayment	Boolean	True/False flag to identify if last payment was amde
narrativeCodes	[String]	Narrative codes that might include bankcruptcy codes
bankruptcyDateFiled	String	Bankruptcy Record Date. This come from the credit report and does not need to be updated.
currentBalance	Float	Current debt balance
originalBalance	Float	Original debt balance
nawSignedDate	Date	Only applicable to JOINT debt. The date when the non-applicant waiver has been signed.
nawUrl	String	Only applicable to JOINT debt. The url to the non-applicant waiver document’s file
hasProofOfLiability	Boolean	Has provided proof of liability
forthDebtTypeId	String	Forth Debt Type ID
remarks	[String]	Remarks
isCollection	Boolean	Flag to show if the debt is in collection
approvedAccountTypeCheck	Boolean	True/False flag to identify if this underwriting check passed
unacceptableCreditorCheck	Boolean	True/False flag to identify if this underwriting check passed
creditUnionAndStateCheck	Boolean	True/False flag to identify if this underwriting check passed
debtOwnershipCheck	Boolean	True/False flag to identify if this underwriting check passed
minimumDebtValueCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateDebtsCheck	Boolean	True/False flag to identify if this debt is selected and a duplicate debt
multipleCreditUnionCheck	Boolean	True/False flag to identify if this underwriting check passed
paymentHistoryCheck	Boolean	True/False flag to identify if this underwriting check passed
unsecuredDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
bankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
employerIsCreditorCheck	Boolean	True/False flag to identify if the creditor is the same as employer
standaloneDebtsCheck	Boolean	True/False flag to identify if the creditor is a standalone debt
coApplicantCheck	Boolean	Only applicable to JOINT debt. True/False flag to identify if this underwriting check passed
currAndOgBalanceCheck	Boolean	Current and original balance check
proofOfLiabilityCheck	Boolean	Proof of liability
delinquency	String	account rating /delinquency value
monthlyPayment	Float	Monthly payment
notes	[String]	Debt Notes

UwResultDebtHistory

Historical record of changes made to a debt

Field	Type	Description
isSelected	Boolean	Whether the debt was selected for enrollment at this revision
coApplicantIsSelected	Boolean	Whether the co-applicant had selected this debt at this revision
exceptions	[String]	Exceptions applied to the debt at this revision
source	String	Source of the debt (MANUAL or CREDIT_REPORT)
creditorName	String	Creditor name at this revision
originalCreditorName	String	Original creditor name at this revision
creditorType	String	Creditor type at this revision
ecoaCode	String	ECOA code at this revision
accountType	String	Account type at this revision
portfolioType	String	Portfolio type at this revision
debtType	String	Debt type at this revision
openDate	String	Open date at this revision
lastPaymentDate	String	Last payment date at this revision
hasLastPayment	Boolean	Whether last payment was made at this revision
currentBalance	Float	Current balance at this revision
originalBalance	Float	Original balance at this revision
narrativeCodes	[String]	Narrative codes at this revision
bankruptcyDateFiled	String	Bankruptcy date filed at this revision
nawSignedDate	Date	Non-applicant waiver signed date at this revision
nawUrl	String	Non-applicant waiver URL at this revision
hasProofOfLiability	Boolean	Whether proof of liability was provided at this revision
isCollection	Boolean	Whether the debt was in collection at this revision
remarks	[String]	Remarks at this revision
monthlyPayment	Float	Monthly payment at this revision
updatedBy	ID	User ID who made this update
fromRevision	Int	The revision number this history entry was created from

UwResultHistory

Historical record of changes made to the underwriting result

Field	Type	Description
applicantInfo	ApplicantInfo	Applicant information at this revision
leadId	String	Lead ID at this revision
updatedBy	ID	User ID who made this update
fromRevision	Int	The revision number this history entry was created from

ApplicantInfo

Field	Type	Description
publicRecords	[PublicRecord]	Public records from the credit report.
applicantContactInfo	ApplicantContactInfo	Applicant’s contact information
coApplicantContactInfo	ApplicantContactInfo	Co-applicant’s contact information
agentAssigned	String	Agent userId set by the integrating CRM to identify the agent in its system.
plan	Plan	Enrollment plan.
budget	Budget	Budget.
additionalInfo	AdditionalInfo	Additional info

PublicRecord

Public Record

Field	Type	Description
bankruptcyCode	String!	Bankcrupty code
bankruptcyDateFiled	String	Bankcrupty date filed
bankruptcyDispositionType	String	Bankcrupty disposition type

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

Plan

Field	Type	Description
frequency	String	Frequency of the enrollment plan. Ex: Monthly, Bi-Weekly
firstPaymentAmount	Float	First payment amount. Ex: 100, 123.45,
secondPaymentAmount	Float	Second payment amount. Ex: 100, 123.45,
firstPaymentDate	String	First payment date.
secondPaymentDate	String	Second payment date.
firstDraftException	String	First draft exception.
programTerm	Int	Program term.
feePercentage	Float	Fee percentage.
epfReduction	String	EPF reduction. Ex: YES, NO
planId	String	Enrollment plan ID.

Budget

Field	Type	Description
totalMonthlyIncome	Float	Total monthly income.
totalMonthlyExpense	Float	Total monthly expenses.

AdditionalInfo

Field	Type	Description
debtAmountException	String	Debt amount exception
includeUnacceptableCreditor	Boolean	Include unacceptable creditor
termExtensionException	Float	Term extension exception value
standaloneDebtsException	Boolean	Standalone debts exception
eomFirstDraftDateException	Boolean	EOM first draft date exception

JointUwResult

Joint underwriting result containing shared debts between applicants

Field	Type	Description
id	ID!	Unique identifier for the joint underwriting result
primaryApplicantUwResult	ApplicantUwResultInfo	Primary applicant uw result id
coApplicantUwResult	ApplicantUwResultInfo	Co-applicant uw result id
uwOrgId	String	The organization underwriting rules used for this application. For example alv or glg
reqOrgId	String	Requesting organization ID
revision	Int!	Document revision number. Each time the document is edited the revision number is incremented
leadId	String	Sigma lead ID
creditReportId	String	Primary applicant credit report ID
coCreditReportId	String	Secondary applicant credit report ID, if applicable (For JOINT application only)
applicantInfo	JointUwApplicantInfo!	Applicant information needed for the root filters
debts	[UwResultDebt]!	List of debts. Each debt will have additional underwriting pass/fail information
creditReportSource	String!	Source can be SPINWHEEL, CRS_TRANSUNION, or CRS_EQUIFAX
rootHistory	[JointUwResultHistory]	History of edits applied to the top level fields of this application
createdAt	Date	Date and time this joint underwriting result was created

ApplicantUwResultInfo

Reference information for an applicant’s underwriting result

Field	Type	Description
id	ID	Underwriting result ID
revision	Int	Current revision number of the underwriting result

ApplicantUwResultInfo

Reference information for an applicant’s underwriting result

Field	Type	Description
id	ID	Underwriting result ID
revision	Int	Current revision number of the underwriting result

JointUwApplicantInfo

Field	Type	Description
applicantContactInfo	ApplicantContactInfo	Applicant’s contact information
coApplicantContactInfo	ApplicantContactInfo	Co-applicant’s contact information

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

UwResultDebt

Debt information with underwriting check results

Field	Type	Description
id	ID!	Unique identifier for the debt
applicantId	String	Primary applicant ID
coApplicantId	String	Secondary applicant ID, if applicable (For JOINT application only)
externalDebtId	ID	This is replaced by accountNumber @deprecated Use accountNumber instead
accountNumber	String	Debt account number
externalCrmId	String	Optional field to identify the debt in the requesting CRM
isSelected	Boolean!	True/False flag to identify if this debt is selected for program enrollment
coApplicantIsSelected	Boolean	Only applicable to JOINT debt. True/False flag to identify if this debt is selected by the co-applicant
eligibilityStatus	EligibilityStatus!	Identify the eligibility status
isOverridden	Boolean	True/False flag to identify if the eligiblity status is being overriden
exceptions	[String]	List of reasons the eligibility status is being overridden
history	[UwResultDebtHistory]	History of all the updates made to this debt
source	String!	Source of the debt entry can be MANUAL or CREDIT_REPORT
creditorName	String	creditor name
parentCreditorName	String	Parent creditor name
parentCreditorId	String	Parent creditor ID
originalCreditorName	String	Original creditor name
creditorId	ID	Creditor ID from Forth
creditorType	String	creditor type
ecoaCode	String	ECOA Code
accountType	String	Account type
portfolioType	String	Portfolio type
debtType	String	Debt type
openDate	String	Date debt was opened
lastPaymentDate	String	Date of the last payment
hasLastPayment	Boolean	True/False flag to identify if last payment was amde
narrativeCodes	[String]	Narrative codes that might include bankcruptcy codes
bankruptcyDateFiled	String	Bankruptcy Record Date. This come from the credit report and does not need to be updated.
currentBalance	Float	Current debt balance
originalBalance	Float	Original debt balance
nawSignedDate	Date	Only applicable to JOINT debt. The date when the non-applicant waiver has been signed.
nawUrl	String	Only applicable to JOINT debt. The url to the non-applicant waiver document’s file
hasProofOfLiability	Boolean	Has provided proof of liability
forthDebtTypeId	String	Forth Debt Type ID
remarks	[String]	Remarks
isCollection	Boolean	Flag to show if the debt is in collection
approvedAccountTypeCheck	Boolean	True/False flag to identify if this underwriting check passed
unacceptableCreditorCheck	Boolean	True/False flag to identify if this underwriting check passed
creditUnionAndStateCheck	Boolean	True/False flag to identify if this underwriting check passed
debtOwnershipCheck	Boolean	True/False flag to identify if this underwriting check passed
minimumDebtValueCheck	Boolean	True/False flag to identify if this underwriting check passed
duplicateDebtsCheck	Boolean	True/False flag to identify if this debt is selected and a duplicate debt
multipleCreditUnionCheck	Boolean	True/False flag to identify if this underwriting check passed
paymentHistoryCheck	Boolean	True/False flag to identify if this underwriting check passed
unsecuredDebtCheck	Boolean	True/False flag to identify if this underwriting check passed
bankruptcyCheck	Boolean	True/False flag to identify if this underwriting check passed
employerIsCreditorCheck	Boolean	True/False flag to identify if the creditor is the same as employer
standaloneDebtsCheck	Boolean	True/False flag to identify if the creditor is a standalone debt
coApplicantCheck	Boolean	Only applicable to JOINT debt. True/False flag to identify if this underwriting check passed
currAndOgBalanceCheck	Boolean	Current and original balance check
proofOfLiabilityCheck	Boolean	Proof of liability
delinquency	String	account rating /delinquency value
monthlyPayment	Float	Monthly payment
notes	[String]	Debt Notes

UwResultDebtHistory

Historical record of changes made to a debt

Field	Type	Description
isSelected	Boolean	Whether the debt was selected for enrollment at this revision
coApplicantIsSelected	Boolean	Whether the co-applicant had selected this debt at this revision
exceptions	[String]	Exceptions applied to the debt at this revision
source	String	Source of the debt (MANUAL or CREDIT_REPORT)
creditorName	String	Creditor name at this revision
originalCreditorName	String	Original creditor name at this revision
creditorType	String	Creditor type at this revision
ecoaCode	String	ECOA code at this revision
accountType	String	Account type at this revision
portfolioType	String	Portfolio type at this revision
debtType	String	Debt type at this revision
openDate	String	Open date at this revision
lastPaymentDate	String	Last payment date at this revision
hasLastPayment	Boolean	Whether last payment was made at this revision
currentBalance	Float	Current balance at this revision
originalBalance	Float	Original balance at this revision
narrativeCodes	[String]	Narrative codes at this revision
bankruptcyDateFiled	String	Bankruptcy date filed at this revision
nawSignedDate	Date	Non-applicant waiver signed date at this revision
nawUrl	String	Non-applicant waiver URL at this revision
hasProofOfLiability	Boolean	Whether proof of liability was provided at this revision
isCollection	Boolean	Whether the debt was in collection at this revision
remarks	[String]	Remarks at this revision
monthlyPayment	Float	Monthly payment at this revision
updatedBy	ID	User ID who made this update
fromRevision	Int	The revision number this history entry was created from

JointUwResultHistory

Historical record of changes made to a joint underwriting result

Field	Type	Description
applicantInfo	JointUwApplicantInfo	Applicant information at this revision
leadId	String	Lead ID at this revision
updatedBy	ID	User ID who made this update
fromRevision	Int	The revision number this history entry was created from

JointUwApplicantInfo

Field	Type	Description
applicantContactInfo	ApplicantContactInfo	Applicant’s contact information
coApplicantContactInfo	ApplicantContactInfo	Co-applicant’s contact information

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

ApplicantContactInfo

Field	Type	Description
employerName	String	Applicant employer name
isMarriedToCoApplicant	Boolean	True/False flag to identify if the applicant is married to the co-applicant
homeAddress	String	Applicant home address.
applicantState	String!	Applicant state.
ssn	String	Applicant SSN.
dob	String	Applicant date of birth.
phone	String	Applicant phone number.
cellPhone	String	Applicant cell phone number.
firstName	String	Applicant first name.
lastName	String	Applicant last name.
jobTitle	String	Applicant job title.
email	String	Applicant email.
hardship	String	Applicant hardship reason.
filedBankruptcy	String	Has the applicant filed bankruptcy.
routingNumber	String	Applicant routing number.
bankName	String	Applicant bank name.
bankAccountNumber	String	Applicant bank account number.
bankAccountHolderName	String	Applicant bank account holder name.
bankAccountType	String	Applicant bank account type.
eligibilityReqMilitary	String	Applicant eligibility requirement for military.
eligibilityReqCreditCounselling	String	Applicant eligibility requirement for credit counselling.
eligibilityReqBankruptcy	String	Applicant eligibility requirement for bankruptcy.
eligibilityReqFederalGovDebt	String	Applicant eligibility requirement for federal government debt.
eligibilityReqSecuredDebt	String	Applicant eligibility requirement for secured debt.
belongsToCompanyId	String	The Forth Pay company ID that the applicant belongs to.

TradelineMetadata

Field	Type	Description
enrolledUpstartDebtAccountNumbers	[String]	List of externalDebtsId’s that belong to selected Upstart debts, if empty then none
enrolledCapitalOneDebtAccountNumbers	[String]	List of externalDebtsId’s that belong to selected Catipal One debts, if empty then none
enrolledDiscoverDebtAccountNumbers	[String]	List of externalDebtsId’s that belong to selected Discover debts, if empty then none

EligibilityResponseError

Includes a list of reasons why the underwriting did not pass

Possible reason are Ineligible, Condition, and Update Needed.

If an error does not include a debtId then it is an application level error.

Field	Type	Description
debtId	String	The debtId of the debt that caused the error.
filterName	String	The name of the underwriting check that caused the error.
message	[String]	The list of reasons why the underwriting check did not pass.

Additional Enums

EligibilityStatus

Eligibility status for a debt

Value	Description
ELIGIBLE	Debt meets all underwriting criteria and can be enrolled
INELIGIBLE	Debt does not meet underwriting criteria and cannot be enrolled
CONDITIONAL	Debt requires additional conditions to be met before enrollment
UPDATE_NEEDED	Debt requires additional information to determine eligibility
UNABLE_TO_PROCESS	Unable to process the debt eligibility check

Error Types

The response may include the following error types:

EligibilityResponseError

Includes a list of reasons why the underwriting did not pass

Possible reason are Ineligible, Condition, and Update Needed.

If an error does not include a debtId then it is an application level error.

Field	Type	Description
debtId	String	The debtId of the debt that caused the error.
filterName	String	The name of the underwriting check that caused the error.
message	[String]	The list of reasons why the underwriting check did not pass.

Manual Error Documentation

Add service-specific error codes and their resolutions below.

Common Errors

Error Code	Description	Resolution
VALIDATION_ERROR	Input validation failed	Check required fields and formats
UNAUTHORIZED	Invalid or expired token	Re-authenticate and retry
NOT_FOUND	Resource not found	Verify the ID or reference

Related

• Back to Lead Eligibility