V3 Amortization Schedule Calculator

Calculates and returns detailed amortization payment schedules for a loan. The API supports the following scenario types: ActualCase, BestCase, and WorstCase. In addition, the API supports Complete and Yearly schedule formats, providing comprehensive payment breakdowns including principal, interest, mortgage insurance, and balances over the loan term.

This API added with the 26.2 release of Encompass.

Usage Notes

  • This API accepts either the loanId query parameter OR loan object in the request body. Note: At least one required. If both missing, API returns HTTP 400 Bad Request.
  • Multiple Scenarios: The API returns ActualCase by default when scenarios not provided. The BestCase and WorstCase available for non-fixed loans.
  • Fixed vs Non-Fixed Loans: For Fixed amortization types, all scenarios return the same schedule since payment schedules don't change across scenarios.
  • Schedule Types: Complete returns all payment periods. Yearly returns annual summaries. Note: When schedules is not provided, API returns both Complete and Yearly schedules.
  • Note: Duplicate values in scenarios or schedules array return HTTP 400 Bad Request.
  • Mortgage Type Support: Standard fields plus USDA and FHA-specific fields.
  • Payment Frequency: Supports Monthly (12 payments/year) and Biweekly (26 payments/year).
Query Params
string

The unique identifier for the loan.

Body Params
scenarios
array of strings

The scenarios to return. Possible enums: actualCase, bestCase, worstCase
Default is actualCase

scenarios
schedules
array of strings

The schedules to return. Possible enums: complete, yearly

  • complete - Returns all payment periods.
  • yearly - Returns annual summaries.
schedules
loan
object

The loan information defined in the LoanContract.

Headers
string
required

Bearer token

Responses

400

Bad Request

401

Unauthorized

403

Forbidden

Language
URL
LoadingLoading…
Response
Choose an example:
application/json