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
- Version 1
- MCP tool
calc_finance_fha_mip - Try it in the browser
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).
| Input | Type | Description |
|---|---|---|
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.
| Result | Type | Description |
|---|---|---|
ltv_percent | decimal (string) | Loan-to-value: base loan ÷ property value. Unit: percent. |
upfront_mip | decimal (string) | The upfront premium: 1.75% of the base loan. Unit: currency. |
loan_amount_with_upfront_mip | decimal (string) | The loan after the upfront premium is added, or the base loan when it is paid in cash. Unit: currency. |
annual_mip_basis_points | integer | The annual premium rate in basis points. |
annual_mip_percent | string | The same rate in percent. |
monthly_mip_at_start | decimal (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_duration | string | How long the annual premium is charged. |
mip_months | integer | The same in months. |
Examples
A 30-year loan of 300,000 on a 310,000 home (LTV above 95%)
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
}'
{
"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
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
}'
{
"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.