> ## 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.

# Liquidate Loan

> Liquidate a loan that is in breach. You receive the collateral that covers the debt, and it is listed for sale from your wallet.

Use it when a loan's collateral no longer covers it, for example after a fall in a stock or commodity price, or when a loan is overdue. Call [Get Liquidation Quote](https://getequity.io/docs/api-reference/endpoint/CreditLoan/get-liquidation-quote.md) first to see what will happen. [Price alerts](https://getequity.io/docs/api-reference/endpoint/CreditLoan/update-price-alerts.md) can tell you when to look.

What happens, in one transaction:

1. Units covering what is owed, at today's sell price, move from the borrower's pledged collateral to your organisation's wallet. When the collateral is worth less than the debt, all of it moves.
2. The rest of the collateral is released back to the borrower.
3. The loan closes with status `LIQUIDATED`.

Then the units you received are **listed for sale** from your wallet, one sell order per token, unless you set `list_for_sale` to `false`. The sale proceeds are yours. GetEquity does not pay out the loan in cash on this path, so the price you sell at, and any `shortfall`, are yours to manage. You can manage the orders like any others: [Get Sell Orders](https://getequity.io/docs/api-reference/endpoint/Orders/get-sell-orders.md), [Cancel Order](https://getequity.io/docs/api-reference/endpoint/Orders/cancel-order.md).

The borrower is told by email, push and in-app notification. You receive a [`loan.liquidated`](https://getequity.io/docs/api-reference/endpoint/Webhook/loan-liquidated) webhook.

> [!WARNING]
>
> A loan that is not in breach is refused with `409` and a message giving its current cover. A loan is in breach when it is past its repayment date plus grace, or its collateral is worth less than 110% of what is owed.

**loanId** `string` *required*

The id of one of your loans.

**reason** `string`

Your reason, kept on the liquidation record (500 characters max).

**list\_for\_sale** `boolean` (default: true)

Put the units you receive up for sale straight away. With `false` they stay in your wallet, and you can sell them later with [Sell Token](https://getequity.io/docs/api-reference/endpoint/Trade/sell-token.md).

**prices** `object[]`

Your own limit price per token, as `[{ "token_id": "...", "price": 98.5 }]`. A token you leave out is listed at its current sell price.

**sales** `object[]`

One entry per token received. `status` is `LISTED`, with the order's `reference`, or `NOT_LISTED`, with an `error` (for example, trading in that token is halted, or the amount is below its minimum sale). Units that were not listed stay in your wallet.

```json theme={null}
{
  "reason": "Collateral cover fell to 105%",
  "prices": [{ "token_id": "659597a28bd0f62d7168c4c8", "price": 104 }]
}
```

```json theme={null}
{
  "status": "success",
  "message": "Loan liquidated successfully",
  "data": {
    "loan_id": "67ef86a1ad2aff781bf01810",
    "status": "LIQUIDATED",
    "currency": "NGN",
    "outstanding": 100000,
    "collateral_value": 105000,
    "coverage": 1.05,
    "coverage_threshold": 1.1,
    "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,
    "reference": "GETXN_LOAN_CREDITOR_LIQUIDATE_A1B2C3D4E",
    "reason": "Collateral cover fell to 105%",
    "liquidated_at": "2026-11-16T16:40:00.000Z",
    "sales": [
      {
        "token_id": "659597a28bd0f62d7168c4c8",
        "symbol": "EXMPL",
        "amount": 952.39,
        "price": 104,
        "status": "LISTED",
        "reference": "GETXN_SELL_F5G6H7J8K"
      }
    ]
  }
}
```


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