---
title: "Calculate mortgage insurance"
method: POST
path: "/api/v1/calculate-pmi"
tags: ["calculations"]
---

# Calculate mortgage insurance

`POST /api/v1/calculate-pmi`

## Request

- Base URL: `https://www.usmortgagecalc.com`
- URL: `https://www.usmortgagecalc.com/api/v1/calculate-pmi`
- Auth: none declared

Mortgage insurance for any US loan programme, including the upfront charges most calculators omit. Conventional: monthly PMI and the month it cancels at 80% and 78% loan-to-value. FHA: the 1.75% upfront premium, monthly MIP, and whether it runs for the life of the loan or ends after 11 years. VA: the funding fee, tiered by down payment and prior use, and waivers. USDA: guarantee and annual fees.

## Request body

- object: Mortgage insurance for any programme: conventional PMI with its cancellation point, FHA MIP and upfront premium, the VA funding fee, or USDA fees.
  - `homePrice` number, required: Purchase price of the home in US dollars.
  - `downPaymentPercent` number: Down payment as a percentage of the purchase price, 0 to 100. Not a dollar amount.
  - `annualInterestRatePercent` number: Annual nominal interest rate as a percentage, for example 6.5 for 6.5%.
  - `loanTermYears` integer: Loan term in years. Most US mortgages are 15 or 30.
  - `loanType` 'conventional' | 'fha' | 'va' | 'usda': Loan programme. Affects mortgage insurance and upfront fees.
  - `monthlyExtraPrincipal` number: Extra principal paid monthly.
  - `creditScore` integer: FHA only: sets the minimum down payment. 580+ qualifies for 3.5%.
  - `vaSubsequentUse` boolean: VA only: entitlement used before.
  - `vaExemptFromFundingFee` boolean: VA only: funding fee waived.

## Response `200`

Calculation result.

- object
  - `data` object: The calculation result.
  - `meta` object
    - `operation` string
    - `computedAt` string, date-time

## Other responses

- `400`: Input failed validation. The message names the offending field.
- `429`: Rate limit exceeded. Retry after the interval in Retry-After.

---

[API](https://skmtc.dev/usmortgagecalc/apis/us-mortgage-calculator-api.md) · [All operations](https://skmtc.dev/usmortgagecalc/apis/us-mortgage-calculator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usmortgagecalc/apis/us-mortgage-calculator-api/revisions/4439848058a8?raw)