> ## Documentation Index
> Fetch the complete documentation index at: https://getequity.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Liquidation Quote

> Check whether one of your loans can be liquidated now, and what would happen if it were. Changes nothing.

Values the loan's collateral at today's **sell price**, the price it can be sold for, and tells you whether the loan is in breach. A loan can be liquidated when either:

* it is **overdue**: past its repayment date plus its grace period, or
* it is **under-collateralised**: its collateral is worth less than `coverage_threshold` (110%) of the amount owed.

The quote also shows how the collateral would be split. You get enough units of each holding to cover what is owed at today's price, and the borrower gets the rest back. When the collateral is worth less than the debt, you get all of it and the difference is reported as `shortfall`.

**loanId** `string` *required*

The id of one of your loans.

**outstanding** `number`

Amount still owed, in major units (naira).

**collateral\_value** `number`

Collateral at today's sell price.

**coverage** `number`

`collateral_value / outstanding`. 1.05 means the collateral covers 105% of the debt.

**liquidatable** `boolean`

Whether [Liquidate Loan](https://getequity.io/docs/api-reference/endpoint/CreditLoan/liquidate-loan.md) would succeed now.

**reasons** `string[]`

`OVERDUE` and/or `UNDER_COLLATERALISED`.

**blocked\_reason** `string`

Present only when `liquidatable` is false. Says why.

**collateral** `object[]`

Per holding: `quantity`, `price`, `value`, and the split: `to_creditor` (units you would receive), `to_creditor_value`, `to_borrower` (units returned).

**covered\_amount** `number`

The part of the debt the units you receive are worth at today's price.

**shortfall** `number`

The part the collateral cannot cover. 0 unless the loan is under water.

```json theme={null}
{
  "status": "success",
  "message": "Liquidation quote fetched successfully",
  "data": {
    "loan_id": "67ef86a1ad2aff781bf01810",
    "status": "ACTIVE",
    "currency": "NGN",
    "outstanding": 100000,
    "collateral_value": 105000,
    "coverage": 1.05,
    "coverage_threshold": 1.1,
    "due_date": "2026-12-31T00:00:00.000Z",
    "grace_ends_at": "2027-01-05T00:00:00.000Z",
    "overdue": false,
    "under_collateralised": true,
    "liquidatable": true,
    "reasons": ["UNDER_COLLATERALISED"],
    "collateral": [
      {
        "token_id": "659597a28bd0f62d7168c4c8",
        "name": "Example Plc",
        "symbol": "EXMPL",
        "quantity": 1000,
        "price": 105,
        "value": 105000,
        "to_creditor": 952.39,
        "to_creditor_value": 100000.95,
        "to_borrower": 47.61
      }
    ],
    "covered_amount": 100000,
    "shortfall": 0
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.