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

FHA mortgage insurance (MIP) API

The upfront and annual mortgage insurance premium on an FHA loan, from HUD's current rate tables, and how long the annual premium is charged.

POST https://api.curatedapi.com/v1/calc/finance/fha-mip

An FHA-insured mortgage carries two insurance premiums. The upfront premium is 1.75% of the base loan amount and is usually added to the loan. The annual premium depends on the loan term, the base loan amount and the loan-to-value ratio, and is charged monthly for 11 years or for the whole mortgage term. This calculator reads both from the tables in HUD Mortgagee Letter 2023-05, which apply to loans endorsed on or after 20 March 2023.

Formula

upfront = 1.75% × base loan; annual rate from the ML 2023-05 table for the term, base loan (up to or above $726,200) and LTV; monthly at start = base loan × rate ÷ 12
  • Rates were compared with the Mortgagee Letter on 12 November 2026.
  • Streamline and simple refinances of older FHA loans, Hawaiian Home Lands and Indian Lands loans have their own premiums and are not covered.
  • HUD rounds a financed loan amount down to the whole dollar; amounts here are kept to the cent.
  • 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
base_loan_amount required decimal (string) The loan before the upfront premium is added. Allowed: > 0 and <= 1000000000000000. Unit: currency.
property_value required decimal (string) The value the loan-to-value ratio is measured against: the lower of the price and the appraised value. Allowed: > 0 and <= 1000000000000000. Unit: currency.
term_years required decimal (string) The mortgage term in years. Allowed: >= 1 and <= 30.
finance_upfront_mip boolean
default True
Whether the upfront premium is added to the 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
ltv_percentdecimal (string)Loan-to-value: base loan ÷ property value. Unit: percent.
upfront_mipdecimal (string)The upfront premium: 1.75% of the base loan. Unit: currency.
loan_amount_with_upfront_mipdecimal (string)The loan after the upfront premium is added, or the base loan when it is paid in cash. Unit: currency.
annual_mip_basis_pointsintegerThe annual premium rate in basis points.
annual_mip_percentstringThe same rate in percent.
monthly_mip_at_startdecimal (string)One twelfth of the annual rate on the starting base loan. The lender works the premium out again each year on the average balance, so it falls as the loan is repaid. Unit: currency.
mip_durationstringHow long the annual premium is charged.
mip_monthsintegerThe same in months.

Examples

A 30-year loan of 300,000 on a 310,000 home (LTV above 95%)

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/fha-mip \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "base_loan_amount": "300000",
    "property_value": "310000",
    "term_years": "30",
    "finance_upfront_mip": true
  }'
200 OKResponse
{
  "calculator": "finance/fha-mip@1",
  "result": {
    "ltv_percent": "96.77",
    "upfront_mip": "5250.00",
    "loan_amount_with_upfront_mip": "305250.00",
    "annual_mip_basis_points": 55,
    "annual_mip_percent": "0.55",
    "monthly_mip_at_start": "137.50",
    "mip_duration": "mortgage term",
    "mip_months": 360
  },
  "exactness": {
    "ltv_percent": "rounded",
    "upfront_mip": "exact",
    "loan_amount_with_upfront_mip": "exact",
    "monthly_mip_at_start": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "base_loan_amount": "300000",
    "property_value": "310000",
    "term_years": "30",
    "finance_upfront_mip": true
  },
  "formula": "upfront = 1.75% × base loan; annual rate from the ML 2023-05 table for the term, base loan (up to or above $726,200) and LTV; monthly at start = base loan × rate ÷ 12",
  "references": [
    {
      "title": "HUD Mortgagee Letter 2023-05: reduction of FHA annual mortgage insurance premium rates (case numbers endorsed on or after 20 March 2023)",
      "url": "https://archives.hud.gov/news/2024/2023-05hsgml.pdf"
    }
  ],
  "warnings": []
}

A 15-year loan with 10% down

Requestcurl
curl https://api.curatedapi.com/v1/calc/finance/fha-mip \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "base_loan_amount": "270000",
    "property_value": "300000",
    "term_years": "15",
    "finance_upfront_mip": true
  }'
200 OKResponse
{
  "calculator": "finance/fha-mip@1",
  "result": {
    "ltv_percent": "90.00",
    "upfront_mip": "4725.00",
    "loan_amount_with_upfront_mip": "274725.00",
    "annual_mip_basis_points": 15,
    "annual_mip_percent": "0.15",
    "monthly_mip_at_start": "33.75",
    "mip_duration": "11 years",
    "mip_months": 132
  },
  "exactness": {
    "ltv_percent": "exact",
    "upfront_mip": "exact",
    "loan_amount_with_upfront_mip": "exact",
    "monthly_mip_at_start": "exact"
  },
  "precision": {
    "rounding": "half_even",
    "decimals": 2
  },
  "inputs": {
    "base_loan_amount": "270000",
    "property_value": "300000",
    "term_years": "15",
    "finance_upfront_mip": true
  },
  "formula": "upfront = 1.75% × base loan; annual rate from the ML 2023-05 table for the term, base loan (up to or above $726,200) and LTV; monthly at start = base loan × rate ÷ 12",
  "references": [
    {
      "title": "HUD Mortgagee Letter 2023-05: reduction of FHA annual mortgage insurance premium rates (case numbers endorsed on or after 20 March 2023)",
      "url": "https://archives.hud.gov/news/2024/2023-05hsgml.pdf"
    }
  ],
  "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.