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.
https://api.api-ninjas.com/v1/mortgagecalculator
Returns monthly payment, annual payment, and interest rate information based on given mortgage parameters.
interest_rate
and either loan_amount
or (home_value
+ downpayment
) must be set.
loan_amount
optionalPrincipal loan amount.
home_value
optionalTotal value of the home or asset. Must be greater than downpayment
.
downpayment
optionalDownpayment on the home or asset. Cannot exceed home_value
.
interest_rate
requiredAnnual interest rate (in %). For example, a 3.5% interest rate would be 3.5
. Cannot exceed 10000
.
duration_years
optionalDuration of the loan in years. Must be between 1
and 10000
. If not set, the default value is 30
years.
monthly_hoa
optionalMonthly homeowner association fees.
annual_property_tax
optionalAnnual property tax owed.
annual_home_insurance
optionalAnnual homeowner's insurance bill.
X-Api-Key
requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/mortgagecalculator?loan_amount=200000&interest_rate=3.5&duration_years=30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"monthly_payment": {
"total": 898,
"mortgage": 898,
"property_tax": 0,
"hoa": 0,
"annual_home_ins": 0
},
"annual_payment": {
"total": 10777,
"mortgage": 10777,
"property_tax": 0,
"hoa": 0,
"home_insurance": 0
},
"total_interest_paid": 123312
}
1
2
3
4
5
6
7
import requests
api_url = 'https://api.api-ninjas.com/v1/mortgagecalculator?loan_amount=200000&interest_rate=3.5&duration_years=30'
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
print(response.text)
else:
print("Error:", response.status_code, response.text)
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.