{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://askcalculators.com/calculator/home-equity-loan-calculator/schema.json",
  "title": "Home Equity Loan Calculator inputs",
  "description": "Estimate a fixed home equity loan payment, borrowing costs, amortization, and an LTV-based borrowing limit.",
  "type": "object",
  "properties": {
    "loanAmount": {
      "title": "Loan amount",
      "type": "number",
      "default": 150000,
      "minimum": 1,
      "x-step": 1000,
      "multipleOf": 1000,
      "x-unit": "currency"
    },
    "annualRate": {
      "title": "Interest rate",
      "type": "number",
      "default": 8,
      "minimum": 0,
      "maximum": 50,
      "x-step": 0.05,
      "x-unit": "percent",
      "x-control": "slider-number"
    },
    "termYears": {
      "title": "Loan term",
      "type": "number",
      "default": 15,
      "minimum": 1,
      "maximum": 50,
      "x-step": 1,
      "multipleOf": 1,
      "x-suffix": " years"
    },
    "includeClosingCosts": {
      "title": "Include closing costs",
      "type": "boolean",
      "description": "Adds fees to the cost and APR estimate.",
      "default": false
    },
    "closingCostValue": {
      "title": "Closing cost value",
      "type": "number",
      "default": 2,
      "minimum": 0,
      "x-step": 0.1,
      "x-showWhen": {
        "field": "includeClosingCosts",
        "equals": true
      }
    },
    "closingCostUnit": {
      "title": "Closing cost unit",
      "type": "string",
      "default": "percent",
      "enum": [
        "percent",
        "amount"
      ],
      "x-optionLabels": {
        "percent": "Percent of loan",
        "amount": "Dollar amount"
      },
      "x-showWhen": {
        "field": "includeClosingCosts",
        "equals": true
      }
    },
    "closingCostTreatment": {
      "title": "Closing cost treatment",
      "type": "string",
      "default": "deducted",
      "enum": [
        "deducted",
        "upfront"
      ],
      "x-optionLabels": {
        "deducted": "Deducted from loan proceeds",
        "upfront": "Paid upfront"
      },
      "x-showWhen": {
        "field": "includeClosingCosts",
        "equals": true
      }
    },
    "homeValue": {
      "title": "Current home value",
      "type": "number",
      "description": "Used for the borrowing-limit estimate.",
      "default": 500000,
      "minimum": 1,
      "x-step": 1000,
      "multipleOf": 1000,
      "x-unit": "currency"
    },
    "mortgageBalance": {
      "title": "Current mortgage balance",
      "type": "number",
      "default": 230000,
      "minimum": 0,
      "x-step": 1000,
      "multipleOf": 1000,
      "x-unit": "currency"
    },
    "maxLtv": {
      "title": "Maximum combined LTV",
      "type": "number",
      "default": 80,
      "minimum": 1,
      "maximum": 100,
      "x-step": 1,
      "multipleOf": 1,
      "x-unit": "percent",
      "x-control": "slider-number"
    }
  },
  "required": [
    "loanAmount",
    "annualRate",
    "termYears",
    "homeValue",
    "mortgageBalance",
    "maxLtv"
  ],
  "allOf": [
    {
      "if": {
        "properties": {
          "includeClosingCosts": {
            "const": true
          }
        },
        "required": [
          "includeClosingCosts"
        ]
      },
      "then": {
        "required": [
          "closingCostValue"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "includeClosingCosts": {
            "const": true
          }
        },
        "required": [
          "includeClosingCosts"
        ]
      },
      "then": {
        "required": [
          "closingCostUnit"
        ]
      }
    },
    {
      "if": {
        "properties": {
          "includeClosingCosts": {
            "const": true
          }
        },
        "required": [
          "includeClosingCosts"
        ]
      },
      "then": {
        "required": [
          "closingCostTreatment"
        ]
      }
    }
  ],
  "additionalProperties": false,
  "x-askcalculators": {
    "version": "1.0.0",
    "calculatorUrl": "https://askcalculators.com/calculator/home-equity-loan-calculator/",
    "queryExample": "https://askcalculators.com/calculator/home-equity-loan-calculator/?loanAmount=150000&annualRate=8&termYears=15&includeClosingCosts=0&homeValue=500000&mortgageBalance=230000&maxLtv=80",
    "migrationStatus": "new",
    "reviewStatus": "pending",
    "pageStatus": "live",
    "workStatus": "pending",
    "formula": {
      "expression": "M = P × [r(1 + r)ⁿ] ÷ [(1 + r)ⁿ − 1]; limit = home value × LTV − mortgage balance",
      "variables": [
        {
          "symbol": "M",
          "meaning": "monthly principal-and-interest payment"
        },
        {
          "symbol": "P",
          "meaning": "home equity loan amount"
        },
        {
          "symbol": "r",
          "meaning": "monthly interest rate"
        },
        {
          "symbol": "n",
          "meaning": "number of monthly payments"
        },
        {
          "symbol": "LTV",
          "meaning": "maximum combined loan-to-value ratio"
        }
      ],
      "note": "The APR estimate solves the monthly cash flows after closing costs. The lender's disclosed APR may use additional rules or charges."
    },
    "quality": {
      "availability": "live",
      "technicalReviewRecord": "/reviews/home-equity-loan-calculator.json",
      "qualifiedReview": "pending",
      "qualifiedReviewer": null,
      "qualifiedReviewDate": null,
      "formulaVersion": "1.0.0",
      "referenceCoverage": "references-listed",
      "releaseTestScope": "Catalog and regression checks are not a professional formula audit; consult release evidence.",
      "historicalMetadataDate": "2026-08-25",
      "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
    },
    "outputs": {
      "monthlyPayment": {
        "title": "Monthly payment",
        "type": "number",
        "x-format": "currency",
        "x-primary": true
      },
      "totalOfPayments": {
        "title": "Total of loan payments",
        "type": "number",
        "x-format": "currency"
      },
      "totalInterest": {
        "title": "Total interest",
        "type": "number",
        "x-format": "currency"
      },
      "closingCosts": {
        "title": "Closing costs",
        "type": "number",
        "x-format": "currency"
      },
      "totalBorrowingCost": {
        "title": "Interest + closing costs",
        "type": "number",
        "x-format": "currency"
      },
      "cashReceived": {
        "title": "Loan proceeds received",
        "type": "number",
        "x-format": "currency"
      },
      "cashDueAtClosing": {
        "title": "Cash due at closing",
        "type": "number",
        "x-format": "currency"
      },
      "estimatedApr": {
        "title": "Cash-flow APR estimate",
        "type": "number",
        "x-format": "percent",
        "x-digits": 3
      },
      "estimatedBorrowingLimit": {
        "title": "LTV-based borrowing limit",
        "type": "number",
        "x-format": "currency"
      },
      "combinedLtv": {
        "title": "Combined LTV with this loan",
        "type": "number",
        "x-format": "percent",
        "x-digits": 2
      }
    }
  }
}