FHA loan calculator

A loan that exceeds the 2026 nationwide one-unit high-cost FHA ceiling fails with invalid_input instead of inventing an uninsurable schedule.

What an FHA monthly payment includes and how the formula is built

When r is greater than zero the closed form for principal and interest is F times r times (1 plus r) to the n, divided by (1 plus r) to the n minus one, with n equal to term_years times twelve. That identity is the standard amortizing installment used for FHA forward mortgages: each installment covers interest on the outstanding financed balance first, then reduces principal. The headline result total_monthly is principal-and-interest plus monthly MIP, rounded to two decimal places so it matches currency.

Input contract, the FHA limit check, and the response shape

Amounts at the ceiling are accepted; amounts above it are not, because no continental county can insure them. POST a JSON body with three required fields: loan_amount, the base amount HUD would insure as a finite number strictly greater than zero (aliases amount, principal, and base_loan); annual_rate, the annual nominal interest as a percent such as 6.5 for six and a half percent per year, finite, at least zero, and at most one hundred (aliases rate and interest_rate); and term_years, the term as a positive integer of years from one through thirty, which is the FHA maximum term (aliases term and years). Each numeric field may arrive as a JSON number or as a numeric string. Missing fields, empty strings, non-finite values, a non-positive loan_amount, a negative annual_rate, and any term_years that is not a positive integer in range fail with invalid_input naming the field and are not billed. The distinctive product rule is the FHA ceiling: if loan_amount is greater than 1249125, the 2026 nationwide one-unit high-cost limit published by HUD, the task fails with invalid_input stating that the amount exceeds the FHA limit. County floors can be lower than this ceiling; this endpoint is not a county lookup and does not invent a local limit. On success the body echoes loan_amount, annual_rate, and term_years, and adds term_months, fha_limit, upfront_mip, financed_amount, annual_mip_rate, monthly_principal_and_interest, monthly_mip, total_monthly, and a formula string restating the identities. Example: loan_amount three hundred thousand, annual_rate 6.5, term_years thirty finances 1.75 percent upfront MIP, amortizes that financed balance over three hundred sixty months, adds monthly MIP at 0.55 percent, and returns the summed total monthly cost. Pair the figure with taxes and homeowner insurance on your own; this endpoint computes FHA credit cost only.

Where an FHA loan calculator earns its keep

Educators teaching FHA versus conventional can seed classroom examples that fail loudly when the amount exceeds the FHA limit, instead of silently producing a payment HUD would never endorse. Content teams can illustrate a fifteen-year FHA note, where annual MIP drops to 0.40 percent, next to a thirty-year note at 0.55 percent, without maintaining a rate table of their own. Failed validation, including the FHA-limit rejection, does not consume balance. Quote tools and origination CRMs can call the same pure module from the browser for free previews and from the API when storing a scenario, guaranteeing that the total monthly a visitor saw matches the total monthly stored after they save a quote. Affordability worksheets already know the base loan; posting loan_amount, annual_rate, and term_years fills a card with principal-and-interest, monthly MIP, financed upfront MIP, and total_monthly so a counselor can see whether a thirty-year quote is even insurable before running a full Loan Estimate. Keep loan_amount strictly positive and at or under the ceiling, pin the rounded money fields in tests, and you get reproducible FHA monthly costs for widgets, LMS modules, and edge workers without a loan-origination stack of your own.