---
title: "List crypto deposits"
method: GET
path: "/v3/deposits/crypto"
tags: ["Crypto deposit"]
---

# List crypto deposits

`GET /v3/deposits/crypto`

## Request

- Base URL: `https://confirmo.net/api`
- URL: `https://confirmo.net/api/v3/deposits/crypto`
- Auth: HTTP bearer

Retrieves a paginated list of crypto deposits with optional filtering by account, address, blockchain network, payment asset code, balance asset code, status, and creation date range.

## Query parameters

- `status` 'CONFIRMING' | 'PENDING_VERIFICATION' | 'UNASSIGNED' | 'DONE' | 'BLOCKED' | 'ABSORBED' | 'FAILED' | 'RETURNED'
- `accountId` string
- `address` string
- `chain` 'ARC-BLOCKCHAIN-MAINNET' | 'BITCOIN-BLOCKCHAIN-MAINNET' | 'BITCOIN-LIGHTNING-MAINNET' | 'BSC-BLOCKCHAIN-MAINNET' | 'ETHEREUM-ARBITRUM-ONE-MAINNET' | 'ETHEREUM-BLOCKCHAIN-MAINNET' | 'ETHEREUM-OPTIMISM-MAINNET' | 'PLASMA-BLOCKCHAIN-MAINNET' | 'ETHEREUM-POLYGON-MAINNET' | 'LITECOIN-BLOCKCHAIN-MAINNET' | 'SOLANA-BLOCKCHAIN-MAINNET' | 'TRON-BLOCKCHAIN-MAINNET'
- `paymentAsset` 'BNB' | 'BTC' | 'ETH' | 'EURC' | 'LTC' | 'POL' | 'SOL' | 'TRX' | 'USAT' | 'USDC' | 'USDG' | 'USDT' | 'XPL'
- `balanceAsset` 'BNB' | 'BTC' | 'ETH' | 'EURC' | 'LTC' | 'POL' | 'SOL' | 'TRX' | 'USAT' | 'USDC' | 'USDG' | 'USDT' | 'XPL' | 'AED' | 'ALL' | 'AMD' | 'ARS' | 'AUD' | 'AZN' | 'BDT' | 'BGN' | 'BHD' | 'BND' | 'BOB' | 'BRL' | 'BYN' | 'CAD' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DKK' | 'DOP' | 'DZD' | 'EUR' | 'FKP' | 'GBP' | 'GEL' | 'GTQ' | 'HKD' | 'HRK' | 'HUF' | 'CHF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JMD' | 'JPY' | 'KGS' | 'KHR' | 'KWD' | 'KZT' | 'LTL' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MNT' | 'MOP' | 'MUR' | 'MXN' | 'MYR' | 'NGN' | 'NIO' | 'NOK' | 'NZD' | 'PEN' | 'PHP' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'USD' | 'UYU' | 'VND' | 'XCD'
- `createdAtFrom` integer
- `createdAtTo` integer
- `limit` integer
- `offset` integer

## Response `200`

Successfully retrieved paginated list of crypto deposits.

- DataPageToCryptoDepositTo
  - `data` CryptoDepositTo[]: The collection of items.
    - `accountId` string: Crypto deposit account identifier.
    - `address` string: Destination crypto address that received the deposit.
    - `balanceAmount` number: Gross amount in the balance asset, before the processing fee is deducted.
    - `balanceAsset` 'CZK' | 'EUR' | 'GBP' | 'USD' | 'PLN' | 'USDC' | 'USDT' | 'USDG': Balance asset code (crypto or fiat).
    - `chain` 'ARC-BLOCKCHAIN-MAINNET' | 'BITCOIN-BLOCKCHAIN-MAINNET' | 'BITCOIN-LIGHTNING-MAINNET' | 'BSC-BLOCKCHAIN-MAINNET' | 'ETHEREUM-ARBITRUM-ONE-MAINNET' | 'ETHEREUM-BLOCKCHAIN-MAINNET' | 'ETHEREUM-OPTIMISM-MAINNET' | 'PLASMA-BLOCKCHAIN-MAINNET' | 'ETHEREUM-POLYGON-MAINNET' | 'LITECOIN-BLOCKCHAIN-MAINNET' | 'SOLANA-BLOCKCHAIN-MAINNET' | 'TRON-BLOCKCHAIN-MAINNET': Blockchain/network identifier of the transfer.
    - `exchangeRate` number: Value is the number of balanceAsset units 1 paymentAsset is worth. Missing when paymentAsset equals balanceAsset (no conversion happened).
    - `feeAmount` number: Processing fee deducted from balanceAmount, in the balance asset. Zero when no fee applies. Null until the balance is calculated (as is balanceAmount); always set once the status is DONE.
    - `id` string: Crypto deposit identifier.
    - `netBalanceAmount` number: balanceAmount minus feeAmount, in the balance asset: the amount credited to the merchant's balance when the status reaches DONE, and always set from that point on. Null until the balance is calculated (as is balanceAmount); a funding that ends in any other status is never credited.
    - `notifyUrl` string, url: Webhook callback URL that will be notified about the crypto deposit updates.
    - `paymentAmount` number: Amount of the crypto asset received in the blockchain transaction (in crypto asset units).
    - `paymentAsset` 'BNB' | 'BTC' | 'ETH' | 'EURC' | 'LTC' | 'POL' | 'SOL' | 'TRX' | 'USAT' | 'USDC' | 'USDG' | 'USDT' | 'XPL': Code of crypto asset used for payment.
    - `receivedAt` integer: Unix timestamp when the deposit was first seen/received.
    - `reference` string: Value of the reference string, copied from the deposit account at creation time of the deposit.
    - `refundDetail` CryptoFundingRefundDetailTo
      - `networkCode` 'BITCOIN-BLOCKCHAIN-MAINNET' | 'LITECOIN-BLOCKCHAIN-MAINNET' | 'ETHEREUM-BLOCKCHAIN-MAINNET' | 'ETHEREUM-ARBITRUM-ONE-MAINNET' | 'ETHEREUM-OPTIMISM-MAINNET' | 'ETHEREUM-POLYGON-MAINNET' | 'BSC-BLOCKCHAIN-MAINNET' | 'SOLANA-BLOCKCHAIN-MAINNET' | 'TRON-BLOCKCHAIN-MAINNET' | 'PLASMA-BLOCKCHAIN-MAINNET': Network the refund transaction was sent on. Limited to the networks on which crypto deposits can be received.
      - `transactionUrl` string, url: URL of the transaction on the blockchain explorer. Null when the network has no configured block explorer.
      - `txHash` string: Transaction hash of the refund transaction
    - `status` 'CONFIRMING' | 'PENDING_VERIFICATION' | 'UNASSIGNED' | 'DONE' | 'BLOCKED' | 'ABSORBED' | 'FAILED' | 'RETURNED': Current processing status of the crypto deposit.
    - `txHash` string: Transaction hash on the blockchain.
  - `limit` integer: The number of returned items.
  - `offset` integer: The number of skipped items.
  - `order` string: The sort column and the order of returned items.
  - `query` string: The searched string in items.
  - `totalCount` integer: The total number of items owned by the merchant.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict

---

[API](https://skmtc.dev/confirmo/apis/confirmo-api.md) - [All operations](https://skmtc.dev/confirmo/apis/confirmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confirmo/apis/confirmo-api/revisions/09bef7db3dd1?raw)