---
title: "Full cash-out refinance waterfall: the largest new loan the property supports across LTV, DSCR and debt-yield, then d..."
method: POST
path: "/api/v1/tools/analyze_cash_out_refinance"
tags: ["Calculators"]
---

# Full cash-out refinance waterfall: the largest new loan the property supports across LTV, DSCR and debt-yield, then d...

`POST /api/v1/tools/analyze_cash_out_refinance`

## Request

- Base URL: `https://relendi.com`
- URL: `https://relendi.com/api/v1/tools/analyze_cash_out_refinance`
- Auth: none declared

Full cash-out refinance waterfall: the largest new loan the property supports across LTV, DSCR and debt-yield, then down through payoff, prepayment penalty and closing costs to net cash in hand. Includes NY CEMA savings when applicable. prepaymentPenaltyPercent is REQUIRED — omitting a penalty overstates the borrower's proceeds by its entire amount, so state 0 explicitly when there is none.

## Request body

- object
  - `noi` number, required
  - `propertyValue` number, required
  - `existingLoanBalance` number, required
  - `state` 'NY' | 'FL', required
  - `rate` number, required: New loan rate, percent (6.85 = 6.85%)
  - `amortizationYears` number, required
  - `prepaymentPenaltyPercent` number, required: Percent of payoff balance. Required — state 0 if none.
  - `cemaEnabled` boolean
  - `maxLtv` number
  - `minDscr` number
  - `minDebtYield` number

## Response `200`

The computed result.

- object
  - `tool` 'analyze_cash_out_refinance', required
  - `deterministic` boolean
  - `result` object, required: Result fields: maxNewLoan, bindingConstraint, byLtv, byDscr, byDebtYield, existingLoanBalance, prepaymentPenalty, totalClosingCosts, grossCashOut, netCashOut, newMonthlyPayment, newAnnualDebtService, newLtv, newDscr, newDebtYield, noCashAvailable, cemaSavings.fullMRT, cemaSavings.cemaMRT, cemaSavings.savings.

## Other responses

- `400`: Error. Possible codes: invalid_input.
- `404`: Error. Possible codes: unknown_tool, not_found.
- `405`: Error. Possible codes: method_not_allowed.
- `429`: Error. Possible codes: rate_limited, quota_exhausted.
- `500`: Error. Possible codes: tool_error.
- `503`: Error. Possible codes: flag_off.

---

[API](https://skmtc.dev/relendi/apis/relendi-public-api.md) · [All operations](https://skmtc.dev/relendi/apis/relendi-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/relendi/apis/relendi-public-api/revisions/7e4b30838121?raw)