Mortgage Calculator API

The Mortgage Calculator API provides detailed mortgage and other home financing payment information. It uses the standard mortgage calculation formulas to calculate interest and monthly/annual payments.

To get the latest and historical mortgage rate data, check out our Mortgage Rate API.

(4.2)

From 8,431 users

800+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
308ms338ms366ms703ms1033ms

Didn't find what you were looking for? Suggest an improvement

/v1/mortgagecalculator GET

https://api.api-ninjas.com/v1/mortgagecalculator

Returns monthly payment, annual payment, and interest rate information based on given mortgage parameters.

Parameters

    interest_rate and either loan_amount or (home_value + downpayment) must be set.

  • loan_amount  optional

    Principal loan amount.

  • home_value  optional

    Total value of the home or asset. Must be greater than downpayment.

  • downpayment  optional

    Downpayment on the home or asset. Cannot exceed home_value.

  • interest_rate  required

    Annual interest rate (in %). For example, a 3.5% interest rate would be 3.5. Cannot exceed 10000.

  • duration_years  optional

    Duration of the loan in years. Must be between 1 and 10000. If not set, the default value is 30 years.

  • monthly_hoa  optional

    Monthly homeowner association fees.

  • annual_property_tax  optional

    Annual property tax owed.

  • annual_home_insurance  optional

    Annual homeowner's insurance bill.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

  • monthly_payment

    Object with the fields total, mortgage, property_tax, hoa, and annual_home_ins representing the monthly amounts in each category.

  • annual_payment

    Object with the fields total, mortgage, property_tax, hoa, and home_insurance representing the annual amounts.

  • total_interest_paid

    Total interest paid over the full term of the loan.

Sample Request Live Demo!

loan_amount
interest_rate
duration_years
home_value
downpayment

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/mortgagecalculator?loan_amount=200000&interest_rate=3.5&duration_years=30

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/mortgagecalculator?loan_amount=200000&interest_rate=3.5&loan_term=30" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.