Skip to content

Investment · Calculation

DSCR loan sizing and rent stress

Enter a residential loan and PITIA components or use owner NOI to size a loan. Includes LTV and income ceilings, interest-only or amortizing debt sizing, loan payment transition and prepayment penalties, rent bands, optional extra principal on the sized amortizing loan and a second scenario. All thresholds are supplied assumptions.

Example result · state: available See output

Cost per success
20 calculation credits
Production plans
Standard, Business, Scale, Enterprise
Plan allowances
Free sandbox
Not available

Integration example

Make a request

Use a production key scoped to investor-dscr-loan.

Keep the key on your server. A successful call uses 20 calculation credits.

Production request

Set HT_PRODUCTION_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.

import { randomUUID } from "node:crypto";

const key = process.env.HT_PRODUCTION_KEY;
if (!key) throw new Error("Set HT_PRODUCTION_KEY on your server.");
const endpoint = "https://calc.hasstechapi.com/v2/calc/investor-dscr-loan";
const input = {
  "scenario": {
    "dscrMode": "lender",
    "grossMonthlyRent": 3000,
    "monthlyOperatingExpenses": 300,
    "lenderDscr": 1.25,
    "interestRate": 6,
    "loanTerm": 30,
    "loanAmount": 240000,
    "monthlyTaxes": 250,
    "monthlyInsurance": 100,
    "monthlyHoa": 50,
    "propertyValue": 400000,
    "maxLtvPct": 75,
    "debtSizingMethod": "amortizing",
    "analysisDate": "2026-09-01",
    "ioPeriodMonths": 12,
    "prepaymentRatesPct": [
      3,
      2,
      1
    ]
  }
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);

const response = await fetch(endpoint, {
  method: "POST",
  redirect: "error",
  headers: {
    "Authorization": "Bearer " + key,
    "Content-Type": "application/json",
    "Idempotency-Key": requestId
  },
  body: JSON.stringify(input)
});
if (!response.ok) {
  const problem = await response.json().catch(() => null);
  const code = problem?.error?.code || response.statusText;
  const delay = response.headers.get("retry-after");
  if (delay) console.error("Retry-After (seconds):", delay);
  console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
  if (Array.isArray(problem?.error?.details)) {
    for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
  }
  process.exitCode = 1;
} else {
  console.log(JSON.stringify(await response.json(), null, 2));
}
cURL (shell)

Set HT_PRODUCTION_KEY on your server. Run in a POSIX shell with cURL 7.76+ and Python 3.7+ to create a request ID.

(
  set -eu
  : "${HT_PRODUCTION_KEY:?Set HT_PRODUCTION_KEY on your server}"
  request_id="${HT_REQUEST_ID:-}"
  if [ -z "$request_id" ]; then
    request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
  fi
  printf 'Usage lookup ID: %s\n' "$request_id" >&2
  # On INVALID_INPUT, read error.details in the JSON response body.
  curl --disable --silent --show-error --fail-with-body --include \
    --request POST 'https://calc.hasstechapi.com/v2/calc/investor-dscr-loan' \
    --header "Authorization: Bearer $HT_PRODUCTION_KEY" \
    --header 'Content-Type: application/json' \
    --header "Idempotency-Key: $request_id" \
    --data-binary @- <<'HT_INPUT'
{
  "scenario": {
    "dscrMode": "lender",
    "grossMonthlyRent": 3000,
    "monthlyOperatingExpenses": 300,
    "lenderDscr": 1.25,
    "interestRate": 6,
    "loanTerm": 30,
    "loanAmount": 240000,
    "monthlyTaxes": 250,
    "monthlyInsurance": 100,
    "monthlyHoa": 50,
    "propertyValue": 400000,
    "maxLtvPct": 75,
    "debtSizingMethod": "amortizing",
    "analysisDate": "2026-09-01",
    "ioPeriodMonths": 12,
    "prepaymentRatesPct": [
      3,
      2,
      1
    ]
  }
}
HT_INPUT
)
If your request fails
400 INVALID_INPUT

Read error.details when present. Node prints each issue. cURL returns the JSON body. Each path points into your request. An empty path refers to the whole body.

Check the accepted inputs for required fields, units and ranges. Send the corrected JSON as a new request.

401 or 403
Check that the server has the bearer key for the endpoint’s environment and that the key includes investor-dscr-loan.
429
Read the service error code, check your allowance, and wait for the Retry-After interval when supplied before trying again.
Lost response, 409 or 503
Open Request lookup, select the same environment and enter the printed usage lookup ID. A settled ID has already consumed credits. To retry the same calculation, set HT_REQUEST_ID to the original ID and reuse the same inputs. A settled request does not return its result again. Unset the variable for a new request, which can consume credits.

The usage lookup ID is the Idempotency-Key your server sends. The response’s x-request-id identifies the HTTP exchange for support.

Output

Example result

These values come from running this operation on the example inputs.

state
available
scenario.sizing.state
available
scenario.sizing.formulaVersion
dscr-loan-2.1.0

Result warnings

  • No lender program was supplied; results are a manual constraint estimate, not an approval.
How to interpret this result
  • Owner mode sizes from annual NOI. Lender mode tests entered monthly PITIA. Dated limits are caller-supplied hypothetical terms, with expired limits excluded. The prepayment schedule uses year-start balances; extra payments use standard amortization at the sized principal.
Full example response (JSON)
{
  "status": "available",
  "result": {
    "state": "available",
    "warnings": [
      {
        "code": "manual-program",
        "severity": "info",
        "message": "No lender program was supplied; results are a manual constraint estimate, not an approval."
      }
    ],
    "scenario": {
      "sizing": {
        "state": "available",
        "fieldErrors": {},
        "warnings": [
          {
            "code": "manual-program",
            "severity": "info",
            "message": "No lender program was supplied; results are a manual constraint estimate, not an approval."
          }
        ],
        "assumptions": [
          {
            "key": "appraisalRentCapPct",
            "value": "100",
            "source": "default"
          },
          {
            "key": "monthlyFixedPitiaCosts",
            "value": "400",
            "source": "user"
          }
        ],
        "provenance": [
          {
            "source": "Declared residential gross-rent/PITIA and commercial NOI/debt-service definitions",
            "asOf": "2026-08-13"
          },
          {
            "source": "Standard monthly level-payment annuity formula, nominal annual rate / 12",
            "asOf": "2026-08-13"
          }
        ],
        "formulaVersion": "dscr-loan-2.1.0",
        "ruleVersions": [
          "residential-gross-rent-pitia",
          "debt-sizing:amortizing",
          "manual-no-program"
        ],
        "auditTrail": [
          "Residential DSCR = qualifying gross monthly rent / monthly PITIA; this is not commercial NOI DSCR.",
          "Sized debt service at 1.25 DSCR and 6% using amortizing.",
          "Monthly PITIA allowance 2400 less fixed costs 400 leaves 2000 for principal and interest.",
          "Constrained maximum is the minimum of DSCR, LTV; limiting constraint LTV."
        ],
        "value": {
          "method": "residential-gross-rent-pitia",
          "sizingMethod": "amortizing",
          "qualifyingAnnualIncome": "36000",
          "suppliedAnnualDebtService": "22067.06",
          "actualDscr": "1.631391220851909656227309003990235296501",
          "effectiveRequiredDscr": "1.25",
          "maxAnnualDebtService": "28800",
          "maxLoanByDscr": "333583.23",
          "maxLoanByLtv": "300000",
          "maxLoanByProgram": null,
          "constrainedMaxLoan": "300000",
          "limitingConstraint": "LTV",
          "requestedLoanAmount": "240000",
          "constraintState": "within-supplied-constraints",
          "programId": null,
          "programAsOf": null,
          "reserveRequirement": null,
          "methodDisclosure": "Residential DSCR = qualifying gross monthly rent / monthly PITIA; this is not commercial NOI DSCR."
        }
      },
      "enteredLoan": {
        "pitia": {
          "principal": 238.9212603666001,
          "interest": 1200,
          "pi": 1438.9212603666,
          "taxes": 250,
          "insurance": 100,
          "hoa": 50,
          "totalPITIA": 1838.9212603666
        },
        "ownerDscr": 1.5984196379265527,
        "annualNoi": 27600,
        "annualDebtService": 17267.0551243992,
        "monthlyPaymentDuringIO": 1200,
        "monthlyPaymentAfterIO": 1456.8110709435,
        "prepaymentPenalties": [
          {
            "year": 1,
            "penalty": 7200
          },
          {
            "year": 2,
            "penalty": 4800
          },
          {
            "year": 3,
            "penalty": 2368.320910163252
          },
          {
            "year": 4,
            "penalty": 0
          },
          {
            "year": 5,
            "penalty": 0
          },
          {
            "year": 6,
            "penalty": 0
          },
          {
            "year": 7,
            "penalty": 0
          },
          {
            "year": 8,
            "penalty": 0
          },
          {
            "year": 9,
            "penalty": 0
          },
          {
            "year": 10,
            "penalty": 0
          }
        ]
      },
      "rentStress": {
        "optimistic": {
          "monthlyCashFlow": 1161.0787396334,
          "capRate": 7.8,
          "allInCapRate": null,
          "dscrLender": 1.7945303429371005,
          "dscrStatus": "available",
          "cashOnCash": 8.7080905472505
        },
        "realistic": {
          "monthlyCashFlow": 861.0787396333999,
          "capRate": 6.9,
          "allInCapRate": null,
          "dscrLender": 1.6313912208519095,
          "dscrStatus": "available",
          "cashOnCash": 6.458090547250499
        },
        "conservative": {
          "monthlyCashFlow": 561.0787396333999,
          "capRate": 6,
          "allInCapRate": null,
          "dscrLender": 1.4682520987667187,
          "dscrStatus": "available",
          "cashOnCash": 4.2080905472504995
        },
        "breakEvenRent": 2139,
        "conservativeBelowBreakEven": false
      },
      "extraPaymentsOnSizedAmortizingLoan": null
    },
    "comparison": null
  },
  "formulaVersion": "dscr-loan-2.1.0",
  "units": {
    "money": "USD",
    "months": "whole months",
    "years": "whole years",
    "percentage": "percent points (6 = 6%)",
    "dscr": "income divided by debt service, unitless"
  },
  "assumptions": [
    "Owner mode sizes from annual NOI. Lender mode tests entered monthly PITIA. Dated limits are caller-supplied hypothetical terms, with expired limits excluded. The prepayment schedule uses year-start balances; extra payments use standard amortization at the sized principal."
  ],
  "warnings": [
    "No lender program was supplied; results are a manual constraint estimate, not an approval."
  ],
  "creditCost": 20
}

Request contract

Accepted inputs

Fields for this example. Expand the schema for all supported combinations and limits.

FieldType, units and limits

scenarioRequired
object
scenario.grossMonthlyRentRequired
number

USD per month in gross rent, before any operating expenses or appraisal rent cap.

Min 0 · Max 1000000000
scenario.monthlyOperatingExpensesRequired
number

USD per month in operating expenses in addition to the separately entered taxes, insurance and association dues.

Min 0 · Max 1000000000
scenario.lenderDscrRequired
number

Required coverage multiple for sizing (1.25 means 1.25 times debt service).

Min 0.01 · Max 10
scenario.interestRateRequired
number

Annual note interest rate in percent (6 means 6% per year).

Min 0 · Max 100
scenario.loanTermRequired
number

Amortization term in years. The sizing engine converts years to the nearest whole month.

Min 0.08333333333333333 · Max 50
scenario.monthlyTaxesRequired
number

USD per month in property taxes.

Min 0 · Max 1000000000
scenario.monthlyInsuranceRequired
number

USD per month in property insurance premiums.

Min 0 · Max 1000000000
scenario.monthlyHoaRequired
number

USD per month in association dues.

Min 0 · Max 1000000000
scenario.propertyValueRequired
number

Caller-supplied property value in USD used as the loan-to-value denominator.

Min 0.01 · Max 1000000000
scenario.maxLtvPctRequired
number

Maximum loan principal as a percent of the entered property value (75 means 75%).

Min 0.01 · Max 100
scenario.appraisalMarketRentOptional
number

USD per month in caller-supplied appraisal market rent.

Min 0.01 · Max 1000000000
scenario.appraisalRentCapPctOptional
number

Percent of entered appraisal market rent allowed in qualifying rent (90 means 90%).

Min 0 · Max 100
scenario.debtSizingMethodRequired
stringAllowed: "amortizing", "interest-only"
scenario.analysisDateRequired
string

Gregorian calendar date, YYYY-MM-DD.

Format: date · Min length 10 · Max length 10
scenario.limitsOptional
object
scenario.limits.asOfRequired
string

Gregorian calendar date, YYYY-MM-DD.

Format: date · Min length 10 · Max length 10
scenario.limits.expiresAtRequired
string

Gregorian calendar date, YYYY-MM-DD.

Format: date · Min length 10 · Max length 10
scenario.limits.requiredDscrOptional
number

Minimum coverage multiple under the dated assumption (1.25 means income is 1.25 times debt service).

Min 0.01 · Max 10
scenario.limits.maxLtvPctOptional
number

Maximum loan as a percent of property value under the dated assumption (75 means 75%).

Min 0.01 · Max 100
scenario.limits.maxLoanOptional
number

Absolute loan principal ceiling in USD under the dated assumption.

Min 0.01 · Max 1000000000
scenario.limits.reserveMonthsOptional
number

Number of months of sized monthly debt payment plus fixed PITIA costs to include in the reserve estimate.

Min 0 · Max 120
scenario.extraMonthlyPrincipalOptional
number

USD per month in additional principal paid on the sized amortizing loan in the payoff comparison.

Min 0 · Max 1000000000
scenario.rentBandsOptional
object
scenario.rentBands.optimisticRequired
number

USD per month in gross rent in the high-rent stress scenario.

Min 0 · Max 1000000000
scenario.rentBands.realisticRequired
number

USD per month in gross rent in the base stress scenario.

Min 0 · Max 1000000000
scenario.rentBands.conservativeRequired
number

USD per month in gross rent in the low-rent stress scenario.

Min 0 · Max 1000000000
scenario.dscrModeRequired
stringMust equal "lender"
scenario.loanAmountRequired
number

USD principal of the entered residential loan used for actual PITIA, payment transitions and penalties.

Min 0.01 · Max 1000000000
scenario.ioPeriodMonthsOptional
integer

Whole months of interest-only payments before amortization begins in the entered-loan illustration.

Min 0 · Max 599
scenario.prepaymentRatesPctOptional
arrayMin items 0 · Max items 10
compareToOptional
object
Example request body (JSON)
{
  "scenario": {
    "dscrMode": "lender",
    "grossMonthlyRent": 3000,
    "monthlyOperatingExpenses": 300,
    "lenderDscr": 1.25,
    "interestRate": 6,
    "loanTerm": 30,
    "loanAmount": 240000,
    "monthlyTaxes": 250,
    "monthlyInsurance": 100,
    "monthlyHoa": 50,
    "propertyValue": 400000,
    "maxLtvPct": 75,
    "debtSizingMethod": "amortizing",
    "analysisDate": "2026-09-01",
    "ioPeriodMonths": 12,
    "prepaymentRatesPct": [
      3,
      2,
      1
    ]
  }
}
Full JSON schema
{
  "type": "object",
  "properties": {
    "scenario": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "grossMonthlyRent": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in gross rent, before any operating expenses or appraisal rent cap."
            },
            "monthlyOperatingExpenses": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in operating expenses in addition to the separately entered taxes, insurance and association dues."
            },
            "lenderDscr": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10,
              "description": "Required coverage multiple for sizing (1.25 means 1.25 times debt service)."
            },
            "interestRate": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Annual note interest rate in percent (6 means 6% per year)."
            },
            "loanTerm": {
              "type": "number",
              "minimum": 0.08333333333333333,
              "maximum": 50,
              "description": "Amortization term in years. The sizing engine converts years to the nearest whole month."
            },
            "monthlyTaxes": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property taxes."
            },
            "monthlyInsurance": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property insurance premiums."
            },
            "monthlyHoa": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in association dues."
            },
            "propertyValue": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "Caller-supplied property value in USD used as the loan-to-value denominator."
            },
            "maxLtvPct": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 100,
              "description": "Maximum loan principal as a percent of the entered property value (75 means 75%)."
            },
            "appraisalMarketRent": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "USD per month in caller-supplied appraisal market rent."
            },
            "appraisalRentCapPct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Percent of entered appraisal market rent allowed in qualifying rent (90 means 90%)."
            },
            "debtSizingMethod": {
              "enum": [
                "amortizing",
                "interest-only"
              ]
            },
            "analysisDate": {
              "type": "string",
              "format": "date",
              "minLength": 10,
              "maxLength": 10,
              "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
              "description": "Gregorian calendar date, YYYY-MM-DD."
            },
            "limits": {
              "type": "object",
              "properties": {
                "asOf": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "expiresAt": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "requiredDscr": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 10,
                  "description": "Minimum coverage multiple under the dated assumption (1.25 means income is 1.25 times debt service)."
                },
                "maxLtvPct": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 100,
                  "description": "Maximum loan as a percent of property value under the dated assumption (75 means 75%)."
                },
                "maxLoan": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 1000000000,
                  "description": "Absolute loan principal ceiling in USD under the dated assumption."
                },
                "reserveMonths": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 120,
                  "description": "Number of months of sized monthly debt payment plus fixed PITIA costs to include in the reserve estimate."
                }
              },
              "required": [
                "asOf",
                "expiresAt"
              ],
              "additionalProperties": false
            },
            "extraMonthlyPrincipal": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in additional principal paid on the sized amortizing loan in the payoff comparison."
            },
            "rentBands": {
              "type": "object",
              "properties": {
                "optimistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the high-rent stress scenario."
                },
                "realistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the base stress scenario."
                },
                "conservative": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the low-rent stress scenario."
                }
              },
              "required": [
                "optimistic",
                "realistic",
                "conservative"
              ],
              "additionalProperties": false
            },
            "dscrMode": {
              "const": "owner"
            }
          },
          "required": [
            "grossMonthlyRent",
            "monthlyOperatingExpenses",
            "lenderDscr",
            "interestRate",
            "loanTerm",
            "monthlyTaxes",
            "monthlyInsurance",
            "monthlyHoa",
            "propertyValue",
            "maxLtvPct",
            "debtSizingMethod",
            "analysisDate",
            "dscrMode"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "grossMonthlyRent": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in gross rent, before any operating expenses or appraisal rent cap."
            },
            "monthlyOperatingExpenses": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in operating expenses in addition to the separately entered taxes, insurance and association dues."
            },
            "lenderDscr": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10,
              "description": "Required coverage multiple for sizing (1.25 means 1.25 times debt service)."
            },
            "interestRate": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Annual note interest rate in percent (6 means 6% per year)."
            },
            "loanTerm": {
              "type": "number",
              "minimum": 0.08333333333333333,
              "maximum": 50,
              "description": "Amortization term in years. The sizing engine converts years to the nearest whole month."
            },
            "monthlyTaxes": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property taxes."
            },
            "monthlyInsurance": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property insurance premiums."
            },
            "monthlyHoa": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in association dues."
            },
            "propertyValue": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "Caller-supplied property value in USD used as the loan-to-value denominator."
            },
            "maxLtvPct": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 100,
              "description": "Maximum loan principal as a percent of the entered property value (75 means 75%)."
            },
            "appraisalMarketRent": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "USD per month in caller-supplied appraisal market rent."
            },
            "appraisalRentCapPct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Percent of entered appraisal market rent allowed in qualifying rent (90 means 90%)."
            },
            "debtSizingMethod": {
              "enum": [
                "amortizing",
                "interest-only"
              ]
            },
            "analysisDate": {
              "type": "string",
              "format": "date",
              "minLength": 10,
              "maxLength": 10,
              "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
              "description": "Gregorian calendar date, YYYY-MM-DD."
            },
            "limits": {
              "type": "object",
              "properties": {
                "asOf": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "expiresAt": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "requiredDscr": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 10,
                  "description": "Minimum coverage multiple under the dated assumption (1.25 means income is 1.25 times debt service)."
                },
                "maxLtvPct": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 100,
                  "description": "Maximum loan as a percent of property value under the dated assumption (75 means 75%)."
                },
                "maxLoan": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 1000000000,
                  "description": "Absolute loan principal ceiling in USD under the dated assumption."
                },
                "reserveMonths": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 120,
                  "description": "Number of months of sized monthly debt payment plus fixed PITIA costs to include in the reserve estimate."
                }
              },
              "required": [
                "asOf",
                "expiresAt"
              ],
              "additionalProperties": false
            },
            "extraMonthlyPrincipal": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in additional principal paid on the sized amortizing loan in the payoff comparison."
            },
            "rentBands": {
              "type": "object",
              "properties": {
                "optimistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the high-rent stress scenario."
                },
                "realistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the base stress scenario."
                },
                "conservative": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the low-rent stress scenario."
                }
              },
              "required": [
                "optimistic",
                "realistic",
                "conservative"
              ],
              "additionalProperties": false
            },
            "dscrMode": {
              "const": "lender"
            },
            "loanAmount": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "USD principal of the entered residential loan used for actual PITIA, payment transitions and penalties."
            },
            "ioPeriodMonths": {
              "type": "integer",
              "minimum": 0,
              "maximum": 599,
              "description": "Whole months of interest-only payments before amortization begins in the entered-loan illustration."
            },
            "prepaymentRatesPct": {
              "type": "array",
              "items": {
                "type": "number",
                "minimum": 0,
                "maximum": 100,
                "description": "Prepayment charge as a percent of the outstanding balance at the start of that loan year. Array position one is loan year one."
              },
              "minItems": 0,
              "maxItems": 10
            }
          },
          "required": [
            "grossMonthlyRent",
            "monthlyOperatingExpenses",
            "lenderDscr",
            "interestRate",
            "loanTerm",
            "monthlyTaxes",
            "monthlyInsurance",
            "monthlyHoa",
            "propertyValue",
            "maxLtvPct",
            "debtSizingMethod",
            "analysisDate",
            "dscrMode",
            "loanAmount"
          ],
          "additionalProperties": false
        }
      ]
    },
    "compareTo": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "grossMonthlyRent": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in gross rent, before any operating expenses or appraisal rent cap."
            },
            "monthlyOperatingExpenses": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in operating expenses in addition to the separately entered taxes, insurance and association dues."
            },
            "lenderDscr": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10,
              "description": "Required coverage multiple for sizing (1.25 means 1.25 times debt service)."
            },
            "interestRate": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Annual note interest rate in percent (6 means 6% per year)."
            },
            "loanTerm": {
              "type": "number",
              "minimum": 0.08333333333333333,
              "maximum": 50,
              "description": "Amortization term in years. The sizing engine converts years to the nearest whole month."
            },
            "monthlyTaxes": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property taxes."
            },
            "monthlyInsurance": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property insurance premiums."
            },
            "monthlyHoa": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in association dues."
            },
            "propertyValue": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "Caller-supplied property value in USD used as the loan-to-value denominator."
            },
            "maxLtvPct": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 100,
              "description": "Maximum loan principal as a percent of the entered property value (75 means 75%)."
            },
            "appraisalMarketRent": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "USD per month in caller-supplied appraisal market rent."
            },
            "appraisalRentCapPct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Percent of entered appraisal market rent allowed in qualifying rent (90 means 90%)."
            },
            "debtSizingMethod": {
              "enum": [
                "amortizing",
                "interest-only"
              ]
            },
            "analysisDate": {
              "type": "string",
              "format": "date",
              "minLength": 10,
              "maxLength": 10,
              "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
              "description": "Gregorian calendar date, YYYY-MM-DD."
            },
            "limits": {
              "type": "object",
              "properties": {
                "asOf": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "expiresAt": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "requiredDscr": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 10,
                  "description": "Minimum coverage multiple under the dated assumption (1.25 means income is 1.25 times debt service)."
                },
                "maxLtvPct": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 100,
                  "description": "Maximum loan as a percent of property value under the dated assumption (75 means 75%)."
                },
                "maxLoan": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 1000000000,
                  "description": "Absolute loan principal ceiling in USD under the dated assumption."
                },
                "reserveMonths": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 120,
                  "description": "Number of months of sized monthly debt payment plus fixed PITIA costs to include in the reserve estimate."
                }
              },
              "required": [
                "asOf",
                "expiresAt"
              ],
              "additionalProperties": false
            },
            "extraMonthlyPrincipal": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in additional principal paid on the sized amortizing loan in the payoff comparison."
            },
            "rentBands": {
              "type": "object",
              "properties": {
                "optimistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the high-rent stress scenario."
                },
                "realistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the base stress scenario."
                },
                "conservative": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the low-rent stress scenario."
                }
              },
              "required": [
                "optimistic",
                "realistic",
                "conservative"
              ],
              "additionalProperties": false
            },
            "dscrMode": {
              "const": "owner"
            }
          },
          "required": [
            "grossMonthlyRent",
            "monthlyOperatingExpenses",
            "lenderDscr",
            "interestRate",
            "loanTerm",
            "monthlyTaxes",
            "monthlyInsurance",
            "monthlyHoa",
            "propertyValue",
            "maxLtvPct",
            "debtSizingMethod",
            "analysisDate",
            "dscrMode"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "grossMonthlyRent": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in gross rent, before any operating expenses or appraisal rent cap."
            },
            "monthlyOperatingExpenses": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in operating expenses in addition to the separately entered taxes, insurance and association dues."
            },
            "lenderDscr": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10,
              "description": "Required coverage multiple for sizing (1.25 means 1.25 times debt service)."
            },
            "interestRate": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Annual note interest rate in percent (6 means 6% per year)."
            },
            "loanTerm": {
              "type": "number",
              "minimum": 0.08333333333333333,
              "maximum": 50,
              "description": "Amortization term in years. The sizing engine converts years to the nearest whole month."
            },
            "monthlyTaxes": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property taxes."
            },
            "monthlyInsurance": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in property insurance premiums."
            },
            "monthlyHoa": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in association dues."
            },
            "propertyValue": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "Caller-supplied property value in USD used as the loan-to-value denominator."
            },
            "maxLtvPct": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 100,
              "description": "Maximum loan principal as a percent of the entered property value (75 means 75%)."
            },
            "appraisalMarketRent": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "USD per month in caller-supplied appraisal market rent."
            },
            "appraisalRentCapPct": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "Percent of entered appraisal market rent allowed in qualifying rent (90 means 90%)."
            },
            "debtSizingMethod": {
              "enum": [
                "amortizing",
                "interest-only"
              ]
            },
            "analysisDate": {
              "type": "string",
              "format": "date",
              "minLength": 10,
              "maxLength": 10,
              "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
              "description": "Gregorian calendar date, YYYY-MM-DD."
            },
            "limits": {
              "type": "object",
              "properties": {
                "asOf": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "expiresAt": {
                  "type": "string",
                  "format": "date",
                  "minLength": 10,
                  "maxLength": 10,
                  "pattern": "^(?:19|20|21)[0-9]{2}-[0-9]{2}-[0-9]{2}$",
                  "description": "Gregorian calendar date, YYYY-MM-DD."
                },
                "requiredDscr": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 10,
                  "description": "Minimum coverage multiple under the dated assumption (1.25 means income is 1.25 times debt service)."
                },
                "maxLtvPct": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 100,
                  "description": "Maximum loan as a percent of property value under the dated assumption (75 means 75%)."
                },
                "maxLoan": {
                  "type": "number",
                  "minimum": 0.01,
                  "maximum": 1000000000,
                  "description": "Absolute loan principal ceiling in USD under the dated assumption."
                },
                "reserveMonths": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 120,
                  "description": "Number of months of sized monthly debt payment plus fixed PITIA costs to include in the reserve estimate."
                }
              },
              "required": [
                "asOf",
                "expiresAt"
              ],
              "additionalProperties": false
            },
            "extraMonthlyPrincipal": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000000,
              "description": "USD per month in additional principal paid on the sized amortizing loan in the payoff comparison."
            },
            "rentBands": {
              "type": "object",
              "properties": {
                "optimistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the high-rent stress scenario."
                },
                "realistic": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the base stress scenario."
                },
                "conservative": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 1000000000,
                  "description": "USD per month in gross rent in the low-rent stress scenario."
                }
              },
              "required": [
                "optimistic",
                "realistic",
                "conservative"
              ],
              "additionalProperties": false
            },
            "dscrMode": {
              "const": "lender"
            },
            "loanAmount": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 1000000000,
              "description": "USD principal of the entered residential loan used for actual PITIA, payment transitions and penalties."
            },
            "ioPeriodMonths": {
              "type": "integer",
              "minimum": 0,
              "maximum": 599,
              "description": "Whole months of interest-only payments before amortization begins in the entered-loan illustration."
            },
            "prepaymentRatesPct": {
              "type": "array",
              "items": {
                "type": "number",
                "minimum": 0,
                "maximum": 100,
                "description": "Prepayment charge as a percent of the outstanding balance at the start of that loan year. Array position one is loan year one."
              },
              "minItems": 0,
              "maxItems": 10
            }
          },
          "required": [
            "grossMonthlyRent",
            "monthlyOperatingExpenses",
            "lenderDscr",
            "interestRate",
            "loanTerm",
            "monthlyTaxes",
            "monthlyInsurance",
            "monthlyHoa",
            "propertyValue",
            "maxLtvPct",
            "debtSizingMethod",
            "analysisDate",
            "dscrMode",
            "loanAmount"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "scenario"
  ],
  "additionalProperties": false,
  "description": "Enter a residential loan and PITIA components or use owner NOI to size a loan. Includes LTV and income ceilings, interest-only or amortizing debt sizing, loan payment transition and prepayment penalties, rent bands, optional extra principal on the sized amortizing loan and a second scenario. All thresholds are supplied assumptions."
}

Production endpoint: POST https://calc.hasstechapi.com/v2/calc/investor-dscr-loan
Formula: dscr-loan-2.1.0

Related PDF reports