---
title: "Liquidation Address Activity Across All Customers"
method: GET
path: "/liquidation_addresses/drains"
tags: ["Liquidation Addresses"]
---

# Liquidation Address Activity Across All Customers

`GET /liquidation_addresses/drains`

History of activity across all customers and Liquidation Addresses

## Query parameters

- `tx_hash` string
- `limit` integer
- `starting_after` string
- `ending_before` string
- `updated_after_ms` integer
- `updated_before_ms` integer
- `drain_id` string

## Response `200`

List of drains for all liquidation addresses (the returned list is empty if none found)

- object
  - `count` integer, required — The number of events returned
  - `data` Drain[], required
    - `id` string, required — A UUID that uniquely identifies a resource
    - `amount` string, required — Amount of the drain, represented as a dollar denominated string. Examples include "100.25", "0.1", "1.234567", "1.01" etc.
    - `customer_id` string, required — A UUID that uniquely identifies a resource
    - `liquidation_address_id` string, required — A UUID that uniquely identifies a resource
    - `currency` 'brl' | 'cop' | 'eur' | 'eurc' | 'gbp' | 'mxn' | 'pyusd' | 'usd' | 'usdb' | 'usdc' | 'usdt', required
    - `state` 'awaiting_funds' | 'in_review' | 'funds_received' | 'payment_submitted' | 'payment_processed' | 'canceled' | 'error' | 'undeliverable' | 'returned' | 'refund_in_flight' | 'refund_failed' | 'refunded', required
    - `created_at` string, date-time — Time of creation of the drain
    - `updated_at` string, date-time — Time of last update of the drain
    - `deposit_tx_hash` string — Hash of the Liquidation Address deposit that triggered this drain
    - `from_address` string — The blockchain address that sent funds to the Liquidation Address
    - `source_payment_rail` string — The source payment rail where the funds originated from
    - `destination` DrainDestination
      - `payment_rail` 'ach' | 'wire' | 'ach_push' | 'ach_same_day' | 'arbitrum' | 'avalanche_c_chain' | 'base' | 'bre_b' | 'co_bank_transfer' | 'celo' | 'ethereum' | 'optimism' | 'pix' | 'polygon' | 'solana' | 'spei' | 'stellar' | 'tempo', required
      - `currency` 'usdb' | 'usdc' | 'usdt' | 'usd' | 'pyusd', required
      - `to_address` string — The crypto wallet address that the customer will ultimately receive funds at
      - `blockchain_memo` string — The memo to include in the transaction, for blockchains that support memos only
      - `external_account_id` string — A UUID that uniquely identifies a resource
      - `wire_message` string — A message to be sent with a wire transfer. It can have up to 140 characters. This message will be validated against 4 lines, each with a max length of 35 characters according to the Fedwire standard.
      - `sepa_reference` string — A reference message to be sent with a SEPA transaction. We recommend you set a unique value to help you and your customers track payments end to end. It must be from 6 to 140 characters. The allowed characters are `a-z`, `A-Z`, `0-9`, spaces, ampersand (`&`), hyphen (`-`), full stop (`.`), and solidus (`/`). If not populated, the default value is "Payment via Bridge {unique_token}".
      - `swift_reference` string — A payment reference message or remittance information to be included in a SWIFT transaction. It can have at most 4 lines (separated by "\n"), each line with a max length of 35 chars. The allowed characters are `a-z`, `A-Z`, `0-9`, special characters (`/` `-` `?` `:` `(` `)` `.` `,` `'` `+`), and space
      - `spei_reference` string — A payment reference message or remittance information to be included in a SPEI transaction. The allowed characters are alphanumeric `a-z`, `A-Z`, `0-9`, and space
      - `reference` union — A payment reference message for newer payment rails (e.g. Pix and Faster Payments).
        - string
        - string
      - `ach_reference` string — A reference message to be sent with an ACH transaction. It can be at most 10 characters, A-Z, a-z, 0-9, and spaces.
      - `imad` string — (Wire only) The IMAD of a wire transfer, if available
      - `trace_number` string — The trace number of an ACH transfer
      - `tracking_number` string — The primary tracking identifier for this fiat transaction. Format varies by payment rail (e.g., UETR for SEPA/FPS, clave de rastreo for SPEI, end-to-end ID for PIX).
      - `transaction_id` string — Deprecated: use tracking_number instead. The unique transaction identifier for this payment.
      - `sending_institution_name` string — The name of the institution sending the funds
      - `uetr` string — Deprecated: use tracking_number instead. The unique end-to-end transaction reference, for tracing purposes.
    - `destination_tx_hash` string — Hash of withdrawal of funds to the destination
    - `refund_tx_hash` string — Hash of refund, if the drain has been returned
    - `return_details` DrainReturnDetails
      - `reason` string — The reason for the return, as given by the returning financial institution.
      - `risk_rejection_reason` string — If the return is due to a risk rejection, this field will be populated with the reason for the risk rejection.
    - `receipt` DrainReceipt
      - `initial_amount` string, required — The initial amount of the drain, denominated in the fiat currency to which the currency of the Liquidation Address is pegged. Examples include "100.25", "0.1", "1.234567", "1.000000000000000001" etc.
      - `developer_fee` string, required — The developer fee, denominated in the fiat currency to which the currency of the Liquidation Address is pegged. This fee is a specific amount deducted from the initial total before conversion, rather than a percentage.
      - `subtotal_amount` string, required — The initial amount of the drain less the `developer_fee`, denominated in the fiat currency to which the Liquidation Address currency is pegged. Examples include "100.25", "0.1", "1.234567", "1.000000000000000001" etc.
      - `gas_fee` string — The fee that is deducted from the withdrawn amount to pay for gas. Only included for crypto withdrawals that cost gas (e.g. USDT). It's denominated in the fiat currency to which the destination currency is pegged.
      - `converted_amount` string, required — The converted amount of the drain. It's denominated in the destination currency or its pegged fiat currency.
      - `exchange_rate` unknown, required
      - `outgoing_amount` string, required — The final amount of the drain, equal to the `converted_amount` minus any gas fees. It's denominated in the destination currency or its pegged fiat currency.
      - `destination_currency` 'usdb' | 'usdc' | 'usdt' | 'usd' | 'pyusd', required
      - `url` string — The URL of a user-facing copy of the receipt.
    - `exchange_details` ExchangeDetails — Exchange information for a currency conversion.
      - `fixed_rate` string — The target exchange rate.
      - `estimated_market_rate` string — The estimated achievable rate based on current market conditions.
      - `traded_market_rate` string — The actual effective exchange rate achieved.
      - `trade_at_market` boolean — Whether market-rate execution has been applied to this trade.
      - `updated_at` string, date-time — Timestamp of the last exchange details update.

## Other responses

- `400` — Request containing missing or invalid parameters.
- `401` — Missing or invalid API key
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)