Skip to main content
This endpoint creates a new loan between a borrower and a lender. Use it to initiate the lending lifecycle, including borrower profile, loan amount, and repayment configuration. What it does:
  • Registers a new loan in the system
  • Accepts borrower, lender, servicer, and loan-specific details
  • Generates a unique loan ID and blockchain transaction hash
When to use it:
  • When setting up a new loan agreement
  • After underwriting approval and before requesting collateral
  • To capture borrower identity and financial metadata

Request Body

The request body should include loan and borrower details. The Request object contains applicant information, application details, vehicle information, and requested terms. The Response object contains risk assessment results including decision, credit scores, and approved loan terms:
Note: The UnderwritingInfo array contains all 60 entries (one for each DealTermsInfo entry), and PrimaryCreditInfo contains all 1136+ credit bureau fields. All attributes from the risk assessment API response are included without modification.
Important fields:
  • installment: Total number of expected repayments (e.g., 12 for monthly repayments over a year)
  • encumbered_status: Indicates whether the collateral is locked during the loan
  • payment_frequency: Common values are MONTHLY, WEEKLY, or ONE_TIME
  • loan_type: Business logic-defined categories (e.g., AUTO, PERSONAL, EDUCATION)