calculations

Build an amortization schedule

Payment-by-payment breakdown of how a loan is repaid, showing the split between principal and interest and the falling balance. Use granularity 'monthly' for the first years in detail, 'yearly' for a whole-term overview. Also reports how much sooner extra principal pays the loan off.

post/api/v1/calculate-amortization

Request

  • Base URL: https://www.usmortgagecalc.com
  • URL: https://www.usmortgagecalc.com/api/v1/calculate-amortization
  • Auth: none declared

Request body

homePricenumber required

Purchase price of the home in US dollars.

downPaymentPercentnumber

Down payment as a percentage of the purchase price, 0 to 100. Not a dollar amount.

annualInterestRatePercentnumber

Annual nominal interest rate as a percentage, for example 6.5 for 6.5%.

loanTermYearsinteger

Loan term in years. Most US mortgages are 15 or 30.

loanType'conventional' | 'fha' | 'va' | 'usda'

Loan programme. Affects mortgage insurance and upfront fees.

annualInsurancenumber

Annual homeowners insurance premium in US dollars.

monthlyHoanumber

Monthly homeowners association dues in US dollars.

monthlyExtraPrincipalnumber

Additional principal paid each month. Shortens the loan rather than lowering the payment.

statestring

Full US state name, for example "Texas". Used to look up the average property tax rate. Either this or propertyTaxRatePercent is required.

propertyTaxRatePercentnumber

Annual property tax as a percentage of home value. Omit and pass state instead to use that state's average.

granularity'yearly' | 'monthly'

Yearly returns one row per year; monthly returns one row per payment, up to 600 rows.

Response

Calculation result.

dataobject

The calculation result.

Changes

No recorded changes to this operation across all 1 revision of this API.