{
  "id": "mortgage-calculator",
  "version": "20.1.0",
  "name": "Mortgage Calculator",
  "shortName": "Mortgage",
  "description": "Estimate principal, interest, taxes, insurance, optional HOA fees, and extra payments.",
  "category": "Finance",
  "categorySlug": "finance",
  "keywords": [
    "home loan",
    "house payment",
    "piti",
    "amortization",
    "interest"
  ],
  "status": "live",
  "workStatus": "pending",
  "reviewStatus": "pending",
  "migrationStatus": "new",
  "engine": "native",
  "creator": null,
  "reviewer": null,
  "quality": {
    "availability": "live",
    "technicalReviewRecord": "/reviews/mortgage-calculator.json",
    "qualifiedReview": "pending",
    "qualifiedReviewer": null,
    "qualifiedReviewDate": null,
    "formulaVersion": "20.1.0",
    "referenceCoverage": "references-listed",
    "releaseTestScope": "Flagship reference cases are specified in scripts/test-v20-1.mjs; consult release evidence for executed results.",
    "historicalMetadataDate": "2026-08-18",
    "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
  },
  "urls": {
    "page": "/calculator/mortgage-calculator/",
    "definition": "/calculator/mortgage-calculator/definition.json",
    "schema": "/calculator/mortgage-calculator/schema.json",
    "llms": "/calculator/mortgage-calculator/llms.txt",
    "legacyDefinition": "/calculator/mortgage-calculator.json"
  },
  "queryExample": "https://askcalculators.com/calculator/mortgage-calculator/?homePrice=350000&downPayment=70000&annualRate=6.5&years=30&propertyTax=4200&insurance=1500",
  "queryParameters": {
    "homePrice": {
      "label": "Home price",
      "type": "money",
      "required": true,
      "default": 350000
    },
    "downPayment": {
      "label": "Down payment",
      "type": "money",
      "required": false,
      "default": 70000
    },
    "annualRate": {
      "label": "Interest rate",
      "type": "percent",
      "required": true,
      "default": 6.5
    },
    "years": {
      "label": "Loan term",
      "type": "select",
      "required": true,
      "default": 30
    },
    "propertyTax": {
      "label": "Annual property tax",
      "type": "money",
      "required": false,
      "default": 4200
    },
    "insurance": {
      "label": "Annual home insurance",
      "type": "money",
      "required": false,
      "default": 1500
    },
    "hoa": {
      "label": "Monthly HOA",
      "type": "money",
      "required": false
    },
    "extraPayment": {
      "label": "Extra monthly payment",
      "type": "money",
      "required": false
    }
  },
  "inputs": [
    {
      "id": "homePrice",
      "label": "Home price",
      "type": "money",
      "required": true,
      "defaultValue": 350000,
      "min": 1,
      "step": 1000,
      "width": "half"
    },
    {
      "id": "downPayment",
      "label": "Down payment",
      "type": "money",
      "defaultValue": 70000,
      "min": 0,
      "step": 1000,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "annualRate",
      "label": "Interest rate",
      "type": "percent",
      "required": true,
      "defaultValue": 6.5,
      "min": 0,
      "max": 20,
      "step": 0.05,
      "control": "slider-number",
      "width": "half"
    },
    {
      "id": "years",
      "label": "Loan term",
      "type": "select",
      "required": true,
      "defaultValue": 30,
      "options": [
        {
          "label": "10 years",
          "value": 10
        },
        {
          "label": "15 years",
          "value": 15
        },
        {
          "label": "20 years",
          "value": 20
        },
        {
          "label": "30 years",
          "value": 30
        }
      ],
      "width": "half"
    },
    {
      "id": "propertyTax",
      "label": "Annual property tax",
      "type": "money",
      "defaultValue": 4200,
      "min": 0,
      "step": 100,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "insurance",
      "label": "Annual home insurance",
      "type": "money",
      "defaultValue": 1500,
      "min": 0,
      "step": 100,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "hoa",
      "label": "Monthly HOA",
      "type": "money",
      "min": 0,
      "step": 10,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "extraPayment",
      "label": "Extra monthly payment",
      "type": "money",
      "min": 0,
      "step": 10,
      "help": "Optional",
      "width": "half"
    }
  ],
  "outputs": [
    {
      "id": "requiredHousingPayment",
      "label": "Required monthly housing payment",
      "format": "currency"
    },
    {
      "id": "extraPrincipal",
      "label": "Optional extra principal",
      "format": "currency"
    },
    {
      "id": "monthlyPayment",
      "label": "Planned monthly payment with extras",
      "format": "currency",
      "primary": true
    },
    {
      "id": "loanAmount",
      "label": "Loan amount",
      "format": "currency"
    },
    {
      "id": "principalInterest",
      "label": "Principal + interest",
      "format": "currency"
    },
    {
      "id": "totalInterest",
      "label": "Total interest",
      "format": "currency"
    },
    {
      "id": "payoffTime",
      "label": "Payoff time",
      "format": "text"
    },
    {
      "id": "totalLoanCost",
      "label": "Principal + interest paid",
      "format": "currency"
    }
  ],
  "formula": {
    "expression": "M = P × [r(1 + r)ⁿ] ÷ [(1 + r)ⁿ − 1]",
    "variables": [
      {
        "symbol": "M",
        "meaning": "monthly principal and interest"
      },
      {
        "symbol": "P",
        "meaning": "loan amount after down payment"
      },
      {
        "symbol": "r",
        "meaning": "monthly interest rate"
      },
      {
        "symbol": "n",
        "meaning": "number of monthly payments"
      }
    ],
    "note": "Taxes, insurance, HOA, and extra payment are added after the loan payment is calculated."
  },
  "examples": [
    {
      "label": "Reproducible default-input example (not a personal recommendation)",
      "inputs": {
        "homePrice": 350000,
        "downPayment": 70000,
        "annualRate": 6.5,
        "years": 30,
        "propertyTax": 4200,
        "insurance": 1500
      }
    }
  ],
  "sources": [
    {
      "label": "Consumer Financial Protection Bureau: mortgage payments",
      "url": "https://www.consumerfinance.gov/ask-cfpb/how-do-mortgage-lenders-calculate-monthly-payments-en-1965/"
    },
    {
      "label": "Consumer Financial Protection Bureau: PITI",
      "url": "https://www.consumerfinance.gov/ask-cfpb/what-is-piti-en-152/"
    },
    {
      "label": "CFPB: principal, interest and total monthly housing payment",
      "url": "https://www.consumerfinance.gov/ask-cfpb/on-a-mortgage-whats-the-difference-between-my-principal-and-interest-payment-and-my-total-monthly-payment-en-1941/"
    },
    {
      "label": "CFPB: how paying down a mortgage works",
      "url": "https://www.consumerfinance.gov/ask-cfpb/how-does-paying-down-a-mortgage-work-en-1943/"
    }
  ]
}