calculations

Calculate a monthly mortgage payment

Full monthly housing cost for a US mortgage: principal and interest, property tax, homeowners insurance, mortgage insurance and HOA dues, plus lifetime totals and payoff timing. Pass a state name to use that state's average property tax rate. This is the right tool for 'what would my payment be on a $400,000 house'.

post/api/v1/calculate-mortgage

Request

  • Base URL: https://www.usmortgagecalc.com
  • URL: https://www.usmortgagecalc.com/api/v1/calculate-mortgage
  • 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.

Response

Calculation result.

dataobject

The calculation result.

Changes

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