Save over 30% when you subscribe to an annual subscription plan!

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