> ## Documentation Index > Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get liquidations > Return a borrower's Morpho Blue liquidation history, most recent first, including positions that no longer appear in Get positions. Available for `morpho-blue-borrow` only; any other `integrationId` returns `400`. `integrationId`, `network` and `address` (the liquidated borrower) are required. `marketId` optionally narrows the history and accepts either a market `id` or the on-chain bytes32 market hash; anything else returns `400`. `offset` defaults to 0; `limit` defaults to 25 and is at most 100. This is the only place a fully liquidated position can still be read. Fields are on [Objects and enums](/api-reference/borrow/objects#liquidations). ## OpenAPI ````yaml openapi-borrow.json GET /v1/positions/liquidations openapi: 3.0.0 info: title: 'Yield API: Borrow' description: API Documentation version: '1.0' contact: {} servers: - url: https://borrow.yield.xyz description: Production security: [] tags: - name: Discovery description: Browse and discover lending markets, integrations, and supported networks - name: Positions description: User-specific supply and borrow positions - name: Actions description: >- Execute actions (supply, borrow, repay, withdraw) and manage multi-step flows - name: Transactions description: Submit signed transactions and track status externalDocs: description: For more information url: https://docs.yield.xyz paths: /v1/positions/liquidations: get: tags: - Positions - Positions summary: Get user liquidation history description: >- Retrieve a paginated history of Morpho Blue liquidation events for a borrower address, read from the indexed store. This is the only place a fully-liquidated (closed) position can be retrieved, since it no longer appears in GET /v1/positions. Ordered by most recent first. operationId: PositionsController_getLiquidations_v1 parameters: - name: offset required: false in: query description: Offset for pagination schema: minimum: 0 default: 0 example: 0 type: number - name: limit required: false in: query description: Maximum number of items to return schema: minimum: 1 maximum: 100 default: 25 example: 25 type: number - name: integrationId required: true in: query description: Integration identifier (must be a Morpho Blue borrow integration) schema: example: morpho-blue-borrow type: string - name: network required: true in: query description: Network schema: example: ethereum type: string enum: - ethereum - ethereum-goerli - ethereum-holesky - ethereum-sepolia - ethereum-hoodi - arbitrum - base - base-sepolia - gnosis - optimism - polygon - polygon-amoy - starknet - zksync - linea - unichain - plume - monad-testnet - monad - robinhood - robinhood-testnet - arc-testnet - arc - avalanche-c - avalanche-c-atomic - avalanche-p - binance - celo - fantom - harmony - moonriver - okc - viction - core - sonic - plasma - katana - hyperevm - tempo - pharos - agoric - akash - axelar - band-protocol - bitsong - canto - chihuahua - comdex - coreum - cosmos - crescent - cronos - cudos - desmos - dydx - evmos - fetch-ai - gravity-bridge - injective - irisnet - juno - kava - ki-network - mars-protocol - nym - okex-chain - onomy - osmosis - persistence - quicksilver - regen - secret - sentinel - sommelier - stafi - stargaze - stride - teritori - tgrade - umee - sei - mantra - celestia - saga - zetachain - dymension - humansai - neutron - polkadot - kusama - westend - bittensor - aptos - binancebeacon - cardano - near - solana - solana-devnet - stellar - stellar-testnet - sui - tezos - tron - ton - ton-testnet - hyperliquid - name: address required: true in: query description: User wallet address (the liquidated borrower) schema: example: '0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28' type: string - name: marketId required: false in: query description: >- Optional market filter. Accepts the integration market id or the on-chain bytes32 market hash. schema: example: morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b... type: string responses: '200': description: Paginated list of liquidation events content: application/json: schema: allOf: - $ref: '#/components/schemas/PaginatedResponseDto' - properties: items: type: array items: $ref: '#/components/schemas/LiquidationDto' '401': description: Invalid or missing API key content: application/json: schema: type: object properties: message: type: string example: Invalid API key error: type: string example: Unauthorized statusCode: type: number example: 401 '429': description: Rate limit exceeded headers: x-ratelimit-limit: description: Request limit per window schema: type: string x-ratelimit-remaining: description: Remaining requests (will be 0) schema: type: string x-ratelimit-reset: description: Unix timestamp when window resets schema: type: string retry-after: description: Seconds to wait before retrying schema: type: string content: application/json: schema: type: object properties: message: type: string example: Rate limit exceeded error: type: string example: Too Many Requests statusCode: type: number example: 429 retryAfter: type: number example: 30 security: - ApiKey: [] components: schemas: PaginatedResponseDto: type: object properties: total: type: number description: Total number of items available example: 150 offset: type: number description: Offset of the current page example: 0 limit: type: number description: Limit of the current page example: 100 required: - total - offset - limit LiquidationDto: type: object properties: id: type: string description: Stable liquidation event id example: liq_0b3f... integrationId: type: string description: Integration ID example: morpho-blue-borrow network: type: string description: Network enum: - ethereum - ethereum-goerli - ethereum-holesky - ethereum-sepolia - ethereum-hoodi - arbitrum - base - base-sepolia - gnosis - optimism - polygon - polygon-amoy - starknet - zksync - linea - unichain - plume - monad-testnet - monad - robinhood - robinhood-testnet - arc-testnet - arc - avalanche-c - avalanche-c-atomic - avalanche-p - binance - celo - fantom - harmony - moonriver - okc - viction - core - sonic - plasma - katana - hyperevm - tempo - pharos - agoric - akash - axelar - band-protocol - bitsong - canto - chihuahua - comdex - coreum - cosmos - crescent - cronos - cudos - desmos - dydx - evmos - fetch-ai - gravity-bridge - injective - irisnet - juno - kava - ki-network - mars-protocol - nym - okex-chain - onomy - osmosis - persistence - quicksilver - regen - secret - sentinel - sommelier - stafi - stargaze - stride - teritori - tgrade - umee - sei - mantra - celestia - saga - zetachain - dymension - humansai - neutron - polkadot - kusama - westend - bittensor - aptos - binancebeacon - cardano - near - solana - solana-devnet - stellar - stellar-testnet - sui - tezos - tron - ton - ton-testnet - hyperliquid example: ethereum address: type: string description: The liquidated borrower address example: '0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28' marketId: type: string description: Market ID example: morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b... type: type: string description: >- Whether the borrower's entire debt in the market was cleared by this liquidation. `full` when no borrow shares remained afterwards (the debt was fully repaid or written off as bad debt); `partial` when debt remained. Null when closure could not be determined — e.g. a liquidation indexed before this was captured, or a failed position read. enum: - partial - full nullable: true example: partial realizedBadDebt: type: boolean description: >- Whether the liquidation realized bad debt: true when the seized collateral was exhausted while the position was still underwater, so the protocol socialized the residual loss to suppliers; false when the seized collateral covered the repaid debt. This is independent of `type` — a `full` liquidation can clear all debt with no bad debt. example: false occurredAt: type: string description: Block timestamp of the liquidation (ISO 8601) example: '2026-05-21T14:08:12.000Z' blockNumber: type: number description: Block number of the liquidation example: 22118447 transactionHash: type: string description: Transaction hash of the liquidation example: 0x8a3f... transactionLink: type: string description: Block explorer URL for the liquidation transaction example: https://etherscan.io/tx/0x8a3f... liquidator: type: string description: Address that performed the liquidation example: 0x... repaidDebt: description: Debt repaid by the liquidator allOf: - $ref: '#/components/schemas/RepaidDebtDto' seizedCollateral: description: Collateral seized from the borrower allOf: - $ref: '#/components/schemas/SeizedCollateralDto' badDebt: description: >- Bad debt socialized by the protocol. Non-zero only when the liquidation realized bad debt. allOf: - $ref: '#/components/schemas/BadDebtDto' lif: type: string description: The market's liquidation incentive factor (LIF). example: '1.0449' required: - id - integrationId - network - address - marketId - type - realizedBadDebt - occurredAt - blockNumber - transactionHash - transactionLink - liquidator - repaidDebt - seizedCollateral - badDebt - lif RepaidDebtDto: type: object properties: tokenAddress: type: string description: Repaid debt token contract address (the market loan token) example: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' tokenSymbol: type: string description: Repaid debt token symbol example: USDC amount: type: string description: Repaid debt in human-readable token units example: '1500.000000' amountRaw: type: string description: Repaid debt in raw token units example: '1500000000' amountUsd: type: string description: >- Repaid debt value in USD, priced at the liquidation block. Null when no historical price is available. example: '1500.00' nullable: true shares: type: string description: Repaid debt in borrow shares example: '1487123456789012345678' required: - tokenAddress - tokenSymbol - amount - amountRaw - amountUsd - shares SeizedCollateralDto: type: object properties: tokenAddress: type: string description: >- Seized collateral token contract address (the market collateral token) example: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf' tokenSymbol: type: string description: Seized collateral token symbol example: cbBTC amount: type: string description: Seized collateral in human-readable token units example: '0.02356500' amountRaw: type: string description: Seized collateral in raw token units example: '2356500' amountUsd: type: string description: >- Seized collateral value in USD, priced at the liquidation block. Null when no historical price is available. example: '1567.34' nullable: true required: - tokenAddress - tokenSymbol - amount - amountRaw - amountUsd BadDebtDto: type: object properties: amountRaw: type: string description: >- Bad debt in raw loan-token units. Non-zero only when the liquidation realized bad debt. example: '0' amount: type: string description: Bad debt in human-readable loan-token units example: '0' amountUsd: type: string description: >- Bad debt value in USD, priced at the liquidation block. Null when no historical price is available. example: '0.00' nullable: true shares: type: string description: Bad debt in borrow shares example: '0' required: - amountRaw - amount - amountUsd - shares securitySchemes: ApiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.