Holiday Sale! Get over 30% off when you subscribe to an annual 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.

(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
326ms345ms376ms800ms1221ms

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