curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

Refinance break-even API

How many months of lower payments it takes to earn back the closing costs of a refinance, and the difference in total cost over the life of the loans.

POST https://api.curatedapi.com/v1/calc/finance/refinance-break-even

Compares keeping a loan with replacing it. It works out the payment on what is left of the current loan and on the new loan, the monthly saving, and the break-even point: the first month by which the savings add up to the closing costs. It also totals every remaining payment on each side, because a lower payment over a longer term can still cost more in the end.

Formula

payment = P·r·(1+r)^n ÷ ((1+r)^n − 1); break-even = closing costs ÷ monthly saving, rounded up to a whole month
  • Each month's interest is rounded to the cent and the last payment clears the balance, as on a lender's schedule.
  • The break-even month does not count interest you could have earned on the closing costs, or tax effects.
  • Amounts are plain numbers in any single currency; no currency conversion is done.

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
current_balance required decimal (string) What is still owed. Allowed: > 0 and <= 1000000000000000. Unit: currency.
current_rate_percent required decimal (string) The current loan's annual rate. Allowed: >= 0 and <= 100. Unit: percent.
remaining_months required integer Months left on the current loan. Allowed: >= 1 and <= 600.
new_rate_percent required decimal (string) The new loan's annual rate. Allowed: >= 0 and <= 100. Unit: percent.
new_term_months required integer The new loan's term in months. Allowed: >= 1 and <= 600.
closing_costs decimal (string)
default 0
Fees and costs of the refinance. Allowed: >= 0 and <= 1000000000000000. Unit: currency.
finance_closing_costs boolean
default False
true when the costs are added to the new loan instead of paid in cash.
options.rounding half_even | half_up | half_down | up | down | ceiling | floor Rounding mode applied once to each result. Default half_even.
options.decimals integer Round results to this many digits after the decimal point.

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
current_paymentdecimal (string)Monthly payment on the current loan. Unit: currency.
new_paymentdecimal (string)Monthly payment on the new loan. Unit: currency.
monthly_savingdecimal (string)current_payment − new_payment. Unit: currency.
break_even_monthsintegerThe first month by which the monthly savings cover the closing costs. Absent when the new payment is not lower.
current_total_remainingdecimal (string)Every remaining payment on the current loan, added up. Unit: currency.
new_total_costdecimal (string)Every payment on the new loan, plus the closing costs when paid in cash. Unit: currency.
lifetime_savingdecimal (string)current_total_remaining − new_total_cost; negative when the refinance costs more overall. Unit: currency.
current_interest_remainingdecimal (string)Interest still to pay on the current loan. Unit: currency.
new_interestdecimal (string)Interest on the new loan. Unit: currency.

Examples

250,000 with 25 years left at 7%, refinanced at 6% for 5,000

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/refinance-break-even \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "current_balance": "250000",
    "current_rate_percent": "7",
    "remaining_months": 300,
    "new_rate_percent": "6",
    "new_term_months": 300,
    "closing_costs": "5000"
  }'
200 OKResponse
{
  "calculator": "finance/refinance-break-even@1",
  "result": {
    "current_payment": "1766.95",
    "new_payment": "1610.75",
    "monthly_saving": "156.20",
    "break_even_months": 33,
    "current_total_remaining": "530083.43",
    "new_total_cost": "488227.37",
    "lifetime_saving": "41856.06",
    "current_interest_remaining": "280083.43",
    "new_interest": "233227.37"
  },
  "exactness": {
    "current_payment": "exact",
    "new_payment": "exact",
    "monthly_saving": "exact",
    "current_total_remaining": "exact",
    "new_total_cost": "exact",
    "lifetime_saving": "exact",
    "current_interest_remaining": "exact",
    "new_interest": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "current_balance": "250000",
    "current_rate_percent": "7",
    "remaining_months": 300,
    "new_rate_percent": "6",
    "new_term_months": 300,
    "closing_costs": "5000",
    "finance_closing_costs": false
  },
  "formula": "payment = P·r·(1+r)^n ÷ ((1+r)^n − 1); break-even = closing costs ÷ monthly saving, rounded up to a whole month",
  "references": [
    {
      "title": "CFPB Regulation Z Appendix H: sample Loan Estimate, the level payment the schedules here are checked against",
      "url": "https://www.consumerfinance.gov/rules-policy/regulations/1026/h/"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.