---
title: "List liquidations"
method: GET
path: "/v0/liquidations"
tags: ["Accounts"]
---

# List liquidations

`GET /v0/liquidations`

## Request

- Base URL: `https://orchestration.seismic.systems/api`
- URL: `https://orchestration.seismic.systems/api/v0/liquidations`
- Auth: API key in header `Api-Key`

Auto-liquidations of virtual-account deposits, newest first — the read-side twin of the `account.deposit_liquidated` webhook event, for reconciliation. `deposit_id` links each liquidation back to the deposit that funded it.

## Query parameters

- `account_id` string, uuid
- `customer_id` string, uuid
- `deposit_id` string, uuid
- `cursor` string
- `limit` integer

## Response `200`

Liquidations page; `next_cursor` is set when more remain.

- ListAccountLiquidationsResponse: Body of `GET /liquidations`. Wrapped rather than returned as a bare array so future fields (cursors, totals) don't break the wire shape. `next_cursor` is set when more pages remain; absent on the last page.
  - `liquidations` ApiAccountLiquidation[], required
    - `account_id` string, uuid, nullable: The virtual account the liquidation drained. Absent when the report named no account Seismic holds.
    - `created_at` string, date-time, required
    - `customer_id` string, uuid, required
    - `deposit_id` string, uuid, nullable
    - `destination_address` string, nullable
    - `destination_chain` string, nullable
    - `exchange_rate` string, nullable
    - `fee` string, nullable
    - `from_amount` string, nullable
    - `from_currency` string, nullable
    - `id` string, uuid, required
    - `status` 'pending' | 'processing' | 'sent' | 'completed' | 'refunded' | 'failed', required: Lifecycle of a liquidation draining a virtual account (`account_liquidations.status`) — the auto-conversion + on-chain settlement of an inbound fiat deposit. Rows are written on the FIRST event describing the payout and advance forward-only as later events land, so a payout that stalls or is refunded stays visible for its whole life instead of being dropped.
    - `status_reason` string, nullable
    - `to_amount` string, nullable
    - `to_currency` string, nullable
    - `transaction_hash` string, nullable: On-chain settlement hash of the crypto leg.
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/seismic/apis/seismic-orchestration-api.md) - [All operations](https://skmtc.dev/seismic/apis/seismic-orchestration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seismic/apis/seismic-orchestration-api/revisions/08ada1f159fa?raw)