{
  "id": "v20-us-mortgage-points",
  "version": "20.16.0",
  "name": "Mortgage Discount Points Calculator — United States",
  "shortName": "Mortgage Discount Points",
  "description": "Compare points using both monthly payments and the mortgage balance still owed at the planned exit date. USD planning view; stated limitations apply.",
  "category": "Finance",
  "categorySlug": "finance",
  "keywords": [
    "mortgage-points",
    "us",
    "consumer-finance",
    "loan-amortization"
  ],
  "status": "live",
  "workStatus": "pending",
  "reviewStatus": "pending",
  "migrationStatus": "new",
  "engine": "native",
  "creator": null,
  "reviewer": null,
  "quality": {
    "availability": "live",
    "technicalReviewRecord": "/reviews/v20-us-mortgage-points.json",
    "qualifiedReview": "pending",
    "qualifiedReviewer": null,
    "qualifiedReviewDate": null,
    "formulaVersion": "20.16.0",
    "referenceCoverage": "references-listed",
    "releaseTestScope": "Catalog and regression checks are not a professional formula audit; consult release evidence.",
    "historicalMetadataDate": "",
    "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
  },
  "notice": "Illustrative defaults are not local quotes or verified legal rules. Dated reference components and user-entered assumptions are explicitly distinguished. Professional review is pending.",
  "urls": {
    "page": "/us/mortgage-points/",
    "definition": "/us/mortgage-points/definition.json",
    "schema": "/us/mortgage-points/schema.json",
    "llms": "/us/mortgage-points/llms.txt",
    "legacyDefinition": "/us/mortgage-points/definition.json"
  },
  "queryExample": "https://askcalculators.com/us/mortgage-points/?principal=300000&rateWithout=6.5&rateWith=6.25&points=1&extraFees=0&termMonths=360&holdingMonths=84",
  "queryParameters": {
    "principal": {
      "label": "Mortgage principal",
      "type": "money",
      "required": true,
      "default": 300000
    },
    "rateWithout": {
      "label": "Annual nominal rate without points",
      "type": "percent",
      "required": true,
      "default": 6.5
    },
    "rateWith": {
      "label": "Annual nominal rate with points",
      "type": "percent",
      "required": true,
      "default": 6.25
    },
    "points": {
      "label": "Points as a percentage of principal",
      "type": "percent",
      "required": true,
      "default": 1
    },
    "extraFees": {
      "label": "Other incremental up-front fees",
      "type": "money",
      "required": true,
      "default": 0
    },
    "termMonths": {
      "label": "Loan term, months",
      "type": "number",
      "required": true,
      "default": 360
    },
    "holdingMonths": {
      "label": "Expected months before sale/refinance",
      "type": "number",
      "required": true,
      "default": 84
    }
  },
  "inputs": [
    {
      "id": "principal",
      "label": "Mortgage principal",
      "type": "money",
      "defaultValue": 300000,
      "required": true,
      "min": 0,
      "max": 1000000000000,
      "step": 0.01,
      "prefix": "USD",
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "rateWithout",
      "label": "Annual nominal rate without points",
      "type": "percent",
      "defaultValue": 6.5,
      "required": true,
      "min": 0,
      "max": 100,
      "step": 0.1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "rateWith",
      "label": "Annual nominal rate with points",
      "type": "percent",
      "defaultValue": 6.25,
      "required": true,
      "min": 0,
      "max": 100,
      "step": 0.1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "points",
      "label": "Points as a percentage of principal",
      "type": "percent",
      "defaultValue": 1,
      "required": true,
      "min": 0,
      "max": 20,
      "step": 0.1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "extraFees",
      "label": "Other incremental up-front fees",
      "type": "money",
      "defaultValue": 0,
      "required": true,
      "min": 0,
      "max": 1000000000000,
      "step": 0.01,
      "prefix": "USD",
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "termMonths",
      "label": "Loan term, months",
      "type": "number",
      "defaultValue": 360,
      "required": true,
      "min": 1,
      "max": 1200,
      "step": 1,
      "help": "Illustrative starting value; replace with your own evidence."
    },
    {
      "id": "holdingMonths",
      "label": "Expected months before sale/refinance",
      "type": "number",
      "defaultValue": 84,
      "required": true,
      "min": 0,
      "max": 1200,
      "step": 1,
      "help": "Illustrative starting value; replace with your own evidence."
    }
  ],
  "outputs": [
    {
      "id": "pointsCost",
      "label": "Incremental up-front cost",
      "format": "currency",
      "digits": 2,
      "currency": "USD"
    },
    {
      "id": "paymentWithout",
      "label": "Payment without points",
      "format": "currency",
      "digits": 2,
      "currency": "USD"
    },
    {
      "id": "paymentWith",
      "label": "Payment with points",
      "format": "currency",
      "digits": 2,
      "currency": "USD"
    },
    {
      "id": "monthlySaving",
      "label": "Monthly payment saving",
      "format": "currency",
      "digits": 2,
      "currency": "USD"
    },
    {
      "id": "breakEven",
      "label": "Simple payment break-even, months",
      "format": "number",
      "digits": 2
    },
    {
      "id": "horizonSaving",
      "label": "Cash plus balance saving at exit horizon",
      "format": "currency",
      "digits": 2,
      "primary": true,
      "currency": "USD"
    }
  ],
  "formula": {
    "expression": "exit-horizon benefit = payment savings to exit + difference in remaining balances − incremental up-front cost.",
    "note": "Inputs are converted to canonical units before evaluating this stated formula."
  },
  "examples": [
    {
      "label": "Illustrative defaults; required verification checks remain unconfirmed",
      "inputs": {
        "unitSystem": "imperial",
        "principal": 300000,
        "rateWithout": 6.5,
        "rateWith": 6.25,
        "points": 1,
        "extraFees": 0,
        "termMonths": 360,
        "holdingMonths": 84
      }
    }
  ],
  "sources": [
    {
      "label": "CFPB loan-estimate explanation",
      "url": "https://www.consumerfinance.gov/owning-a-home/loan-estimate/"
    },
    {
      "label": "CFPB comparing borrowing costs",
      "url": "https://www.consumerfinance.gov/owning-a-home/compare/compare-loan-estimates/"
    }
  ],
  "publicSlug": "mortgage-points",
  "namespace": "us",
  "countries": [
    "us"
  ]
}