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.

/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.

Sample Request Live Demo!

loan_amount
interest_rate
duration_years
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
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 }

Code Examples

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.