Loan Account Summary

This data model captures the essential details found on a loan account statement. It includes information about the lender, the statement period, and the currency used. It details the loan's ownership structure and lists the account holders. Key financial information such as the starting and ending balances for the period, the original loan amount, interest rates, and any accrued interest or fees during the statement period are included. Additionally, it covers payment details like the next due date and amount, the status of the loan payments, year-to-date totals for interest, principal, and fees paid, and information about the loan's maturity date and any collateral involved.

Field name	Type	Description
financial_institution_name	string	Name of the financial institution providing the loan (lender/noteholder).
statement_period_start_date	string	The first day covered by the statement (YYYY-MM-DD).
statement_period_end_date	string	The last day covered by the statement (YYYY-MM-DD).
account_currency	string	The currency of the loan account, represented by a 3-digit ISO code.
ownership_type	string	How the account is legally owned. Values: `individual`, `joint_wros`, `joint_tic`, `trust`, `custodial_utma`, `custodial_ugma`, `fiduciary_guardian`.
holders	array	List of individuals or entities who own the loan account.
holder_name	string	The name of an individual or entity holding the account.
holder_type	string	The classification of the account holder (e.g., Primary, Secondary).
starting_balance_period	number	The outstanding principal amount at the beginning of the statement period.
ending_balance_period	number	The outstanding principal amount at the end of the statement period.
account_type	string	The category of the loan. Values: `mortgage`, `vehicle_loan`, `personal_loan`, `student_loan`, `home_equity_loan`, `other_loan`.
original_loan_amount	number	The initial principal amount borrowed when the loan was first taken out.
origination_date	string	The date the loan agreement was finalized and funds were disbursed (YYYY-MM-DD).
interest_rate	number	The percentage rate charged on the loan principal.
interest_rate_type	string	Indicates if the interest rate is fixed or can change. Values: `fixed`, `variable`.
interest_accrued_period	number	The amount of interest added to the loan balance during the statement period.
fees_charged_period	number	The total amount of fees applied to the account during the statement period.
payment_due_date	string	The date the next loan payment is required (YYYY-MM-DD).
payment_due_amount	number	The amount scheduled to be paid on the next payment due date.
loan_payment_status	string	The current standing of the loan's repayment. Values: `in_repayment`, `deferment`, `forbearance`, `grace_period`, `default`, `paid_off`, `unknown`.
last_payment_amount	number	The amount of the most recent payment received for the loan.
maturity_date	string	The date when the loan is scheduled to be fully repaid (YYYY-MM-DD).
servicer	string	Name of the company managing the loan account, if different from the lender.
interest_paid_ytd	number	The cumulative amount of interest paid since the start of the calendar year.
principal_paid_ytd	number	The cumulative amount of principal paid since the start of the calendar year.
fees_paid_ytd	number	The cumulative amount of fees paid since the start of the calendar year.
collateral_description	string	A description of the asset(s) securing the loan (e.g., property address, vehicle VIN).

Field Notes

Dates: All date fields (statement_period_start_date, statement_period_end_date, origination_date, payment_due_date, maturity_date) should be in YYYY-MM-DD format.
account_currency: This field represents the 3-digit ISO currency code (e.g., USD, CAD, EUR). If not found in the document, it defaults to USD.
ownership_type: Expected values include individual, joint_wros (Joint Tenants with Right of Survivorship), joint_tic (Joint Tenants in Common), trust, custodial_utma (Uniform Transfers to Minors Act), custodial_ugma (Uniform Gifts to Minors Act), fiduciary_guardian.
account_type: Expected values include mortgage, vehicle_loan, personal_loan, student_loan, home_equity_loan, other_loan.
interest_rate_type: Expected values are fixed or variable.
loan_payment_status: Expected values include in_repayment, deferment, forbearance, grace_period, default, paid_off, unknown.
Numbers: Numeric fields like balances, amounts, and rates should be extracted with up to two decimal places.