---
title: "List Transfers"
method: GET
path: "/transfer/transfers"
tags: ["Transfers"]
---

# List Transfers

`GET /transfer/transfers`

List all transfers, optionally filtering and paging the results.

By default, transfers are returned in reverse chronological (descending)
order by creation time.

The recommended polling workflow is to query the results in ascending
order (by setting `order_by` to `CREATED_AT`), keeping track of the
`created_at` timestamp of the most recent transfer in the paged results.
Once transfers are discovered, the caller should store the returned `ID`
and query GetTransfer to retrieve status updates.

## Query parameters

- `profile_ids` string[]
- `identity_ids` string[]
- `ref_ids` string[]
- `created_at.lt` string, date-time
- `created_at.lte` string, date-time
- `created_at.eq` string, date-time
- `created_at.gte` string, date-time
- `created_at.gt` string, date-time
- `updated_at.lt` string, date-time
- `updated_at.lte` string, date-time
- `updated_at.eq` string, date-time
- `updated_at.gte` string, date-time
- `updated_at.gt` string, date-time
- `limit` integer
- `order` 'DESC' | 'ASC'
- `order_by` 'CREATED_AT' | 'UPDATED_AT'
- `page_cursor` string
- `account_ids` string[]
- `ids` string[]
- `type` string[]
- `group_ids` string[]
- `crypto_tx_hashes` string[]
- `secondary_statuses` string[]
- `statuses` string[]

## Response `200`

A successful response.

- ListTransfersResponse
  - `items` Transfer[]
    - `id` string, required — The Paxos transfer ID.
    - `customer_id` string, required — The Paxos customer ID.
    - `profile_id` string, required — The target Profile of the transfer. The profile asset balance is debited or credited by the transfer.
    - `identity_id` string — The Paxos ID of the Identity associated with the transfer.
    - `ref_id` string — The optional client-specified ID for replay protection and lookup.
    - `amount` string, required — The amount sent in the transfer.
    - `total` string, required — The balance change from this transfer: amount - fee for deposits, and amount + fee for withdrawals. Unsigned.
    - `fee` string, required — The fee paid for the transfer.
    - `asset` string, required — The asset for this transfer. This profile's balance of this asset will be debited or credited.
    - `balance_asset` string — The balance_asset represents what asset's balance was affected at Paxos with this transfer. It only differs from Asset when the transfer includes conversion.
    - `direction` 'CREDIT' | 'DEBIT', required — Direction of the transfer.
    - `type` 'INTERNAL_TRANSFER_DEBIT' | 'INTERNAL_TRANSFER_CREDIT' | 'CRYPTO_DEPOSIT' | 'CRYPTO_WITHDRAWAL' | 'WIRE_DEPOSIT' | 'WIRE_WITHDRAWAL' | 'SEN_DEPOSIT' | 'SEN_WITHDRAWAL' | 'BANK_DEPOSIT' | 'BANK_WITHDRAWAL' | 'PAXOS_TRANSFER_DEBIT' | 'PAXOS_TRANSFER_CREDIT' | 'SIGNET_DEPOSIT' | 'SIGNET_WITHDRAWAL' | 'CBIT_WITHDRAWAL' | 'CBIT_DEPOSIT' | 'CUBIX_DEPOSIT' | 'CUBIX_WITHDRAWAL' | 'RTP_DEPOSIT', required — Type of transfer.
    - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required
    - `secondary_status` SecondaryStatus — Secondary status for the transfer, used for more granular explanation of the transfer status.
      - `name` 'TRAVEL_RULE_INFO_REQUESTED' | 'TRAVEL_RULE_REJECTED' | 'CUSTOMER_REJECTED' | 'PENDING_CUSTOMER_APPROVAL' — Identifier for secondary status. - TRAVEL_RULE_INFO_REQUESTED: Travel rule information is required to continue processing the transfer. - TRAVEL_RULE_REJECTED: Transfer has been terminally rejected due to failing travel rule checks. - CUSTOMER_REJECTED: Transfer was rejected by a customer. - PENDING_CUSTOMER_APPROVAL: Transfer is pending customer approval.
      - `detail` string — Additional information about the current status of the transfer (e.g. if information is missing).
    - `status_details` TransferStatusDetails — TransferStatusDetails provides additional information about why a transfer is in its current state. This field is only populated when a transfer encounters specific error conditions or requires additional context.
      - `missing_trustline` MissingTrustline — MissingTrustline represents a failed transfer where the destination account lacks the required asset trustline.
        - `message` string
        - `destination_address` string
        - `asset` string
      - `max_rent_exceeded` MaxRentExceeded — MaxRentExceeded represents a failed transfer that was flagged for system abuse. When a withdrawal's rent calculation for the destination account exceeds the maximum allowed rent threshold, it may indicate malicious behavior. This status detail is set when such transfers are automatically cancelled.
        - `message` string
        - `destination_address` string
      - `pending_customer_approval` PendingCustomerApproval — PendingCustomerApproval represents that this resource is awaiting customer approval.
        - `message` string
        - `awaiting_action_from` 'AWAITING_ACTION_FROM_UNSPECIFIED' | 'AWAITING_ACTION_FROM_CLIENT' | 'AWAITING_ACTION_FROM_PAXOS' — AwaitingActionFrom indicates who needs to act on or is responsible for a given status. - AWAITING_ACTION_FROM_CLIENT: The customer needs to take action. - AWAITING_ACTION_FROM_PAXOS: Paxos needs to take action.
      - `stale_fee_quote` StaleFeeQuote — StaleFeeQuote represents a transfer cancelled because on-chain state changed after the fee was quoted.
        - `message` string
      - `invalid_destination_address` InvalidDestinationAddress — InvalidDestinationAddress represents a transfer cancelled because the destination address cannot receive the requested asset (e.g. it is a token account for a different mint).
        - `message` string
        - `destination_address` string
    - `created_at` string, date-time, required — The time at which this transfer record was created.
    - `updated_at` string, date-time, required — The time at which this transfer record was most recently updated.
    - `metadata` object — Optional client-specified stored metadata. For deposit event transfers this metadata is copied from the crypto deposit address or fiat deposit memo used for attribution. Up to 6 key/value pairs may be returned. Each key and value must be less than or equal to 100 characters.
    - `destination_address` string — The destination crypto address.
    - `crypto_network` 'BITCOIN' | 'ETHEREUM' | 'BITCOIN_CASH' | 'LITECOIN' | 'SOLANA' | 'POLYGON_POS' | 'BASE' | 'ARBITRUM_ONE' | 'STELLAR' | 'INK' | 'XLAYER' | 'AVALANCHE' | 'DOGECOIN' | 'SUI' | 'ROBINHOOD' | 'BNB' — A CryptoNetwork is a blockchain transmitting cryptocurrencies.
    - `crypto_tx_hash` string — For crypto transactions, the on-chain transaction hash.
    - `crypto_tx_index` string — For crypto transactions, the output index or output address.
    - `account_id` string — The Paxos ID of the Account associated with the transfer.
    - `auto_conversion` AutoConversion
      - `from_transfer_id` string
      - `to_transfer_id` string
    - `group_id` string — Unique identifier linking the debit and credit sides of an internal or Paxos transfer.
    - `fiat_account_id` string — For fiat withdrawals, the Paxos ID of the owner's fiat account (UUID).
    - `notional_value` string, decimal — For crypto withdrawals and deposits, the USD value of the combined amount and fee at the time of the transfer.
    - `memo` string — An optional memo to be included with the transfer as an identifier.
  - `next_page_cursor` string

---

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