HomeGuidesAPI Reference
Guides

FinancialDetails

Payitoff API: FinancialDetails Schema

🚧

For historical reasons, FinancialDetails are returned as a nested object in Borrower responses. but most properties are accepted as direct BorrowerPayload properties when creating and updating your Borrower via API.

This discrepancy will be corrected in API v2.

Schema Definition

PropertyTypeFormatDescription
aginumberfloatThe Borrower's Adjusted Gross Income.
childrenintegerint32The number of children (including unborn) a Borrower has.

Defaults to 0.
dependentsintegerint32The number of non-children dependents who receive more than half their support from the Borrower.

Defaults to 0.
employer_statestringState in which the Borrower's current employer is located.
extra_monthly_paymentnumberfloatThe amount of additional payment, if any, the Borrower wishes to make on their loan(s).
family_sizeintegerint32Number of family members, including the Borrower, their spouse, their children (even unborn), and any other dependents who receive more than half of their support from the Borrower.

Defaults to 1.
filing_statusstringsingle
head_of_household
married_filing_jointly
married_filing_separately
Federal tax filing status of Borrower.

Defaults to single.
income_growthnumberfloatExpected income growth per year, as a percentage.

Defaults to 5.0.
new_borrower_datestringdateThe date on which the Borrower first took out student loans.
pslfbooleanInstructs Payitoff to include PSLF forgiveness in Assessment calculations.

Defaults to null.
refinance_ratenumberfloatTODO
refinance_termintegerint32TODO
related_to_majorbooleanTODO
spouse_aginumberfloatIf the Borrower has a spouse, the spouse's Adjusted Gross Income.

NOTE: family_size should be at least 2 if providing spouse_agi to be included in Assessment calculations. You should also choose one of the married_* filing_status values.
state_of_residencestringState in which the borrower legally resides.
tcli_enabledbooleanInstructs Payitoff to include TCLI forgiveness in Assessment calculations.

Defaults to null.
tcli_end_yearstringdateTODO
tcli_start_yearstringdateTODO
teaching_levelstringelementary
middle
secondary
If Borrower is a teacher, what level of education they teach.
teaching_statestringIf Borrower is a teacher, the state where employing school is located.
teaching_subjectstringenglish
math
other
science
special_education
If Borrower is a teacher, the subject they teach.`

Example

{
  "agi": 45500.44,
  "children": 1,
  "dependents": 0,
  "employer_state": null,
  "extra_monthly_payment": 0.00,
  "family_size": 2,
  "filing_status": "single",
  "income_growth": null,
  "new_borrower_date": null,
  "pslf": null,
  "refinance_rate": null,
  "refinance_term": null,
  "related_to_major": null,
  "spouse_agi": 24000.00,
  "state_of_residence": "NV",
  "tcli_enabled": null,
  "tcli_end_year": null,
  "tcli_start_year": null,
  "teaching_level": null,
  "teaching_state": null,
  "teaching_subject": null
}