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

# List transfers

`GET /transfers`

Retrieves a list of objects containing information about transfers. This endpoint supports pagination and filtering based on the below parameters. Results are limited to the last 2 months.

## Query parameters

- `page` number
- `page_size` number
- `to_participant_code` string
- `from_participant_code` string
- `requested_timestamp[gt]` number
- `requested_timestamp[gte]` number
- `requested_timestamp[e]` number
- `requested_timestamp[lt]` number
- `requested_timestamp[lte]` number
- `client_transfer_id` string
- `from_account_group` string
- `from_account_label` string
- `to_account_group` string
- `to_account_label` string
- `currency` 'USDC.OPTIMISM' | 'USDC.SUI' | 'DOT' | 'FIL' | 'PYUSD.ETH' | 'TRX' | 'ZRX' | 'DAI.ETH' | 'USDC.WORLDCHAIN' | 'USDP' | 'USDT.BSC' | 'USDT.CELO' | 'PEPE.ETH' | 'SAND' | 'USDC.DOTHUB' | 'USDC.SEI' | 'USDC.SOL' | 'USDC.ZKSYNC' | 'ENA.ETH' | 'MANA.ETH' | 'PYTH.SOL' | 'SOL' | 'USDC.BASE' | 'USDC.CELO' | 'USDT' | 'ADA' | 'INJ.ETH' | 'MATIC.POLYGON' | 'PAXG' | 'USD' | 'AAVE.ETH' | 'ALGO' | 'EURC.XLM' | 'KNC.ETH' | 'PNUT.SOL' | 'SHIB' | 'BCH' | 'DOGE' | 'EGLD' | 'JTO.SOL' | 'UNI.ETH' | 'USDC' | 'USDC.ARBITRUM' | 'ONDO.ETH' | 'PENGU.SOL' | 'USD' | 'WLFI.ETH' | 'XLM' | 'APT' | 'CC' | 'ETH.OPTIMISM' | 'ETH.WORLDCHAIN' | 'LDO.ETH' | 'MORPHO.ETH' | 'SEI' | 'ETH.ZKSYNC' | 'USDC.AVAX' | 'USDC.XLM' | 'USDT.DOTHUB' | 'USDT.SOL' | 'MANA' | 'USDC.ALGO' | 'MATIC.ETH' | 'NEAR' | 'UNI' | 'USDT.ARBITRUM' | 'USDT.AVAX' | 'OMG' | 'ARB.ARBITRUM' | 'COMP.ETH' | 'GRT.ETH' | 'USDC.POLYGON' | 'AVAX' | 'AAVE' | 'CELO' | 'PYUSD.SOL' | 'PAXG.ETH' | 'USDC.MONAD' | 'BAT' | 'COMP' | 'ETH.ARBITRUM' | 'ETH.BASE' | 'OP.OPTIMISM' | 'TRUMP.SOL' | 'ENJ.ETH' | 'SUI' | 'USDT.ETH' | 'USDT.OPTIMISM' | 'USDT.TRX' | 'USDT.XPL' | 'OMG.ETH' | 'XRP' | 'HBAR' | 'USDC.APT' | 'USDC.ETH' | 'BNB' | 'ATOM' | 'BAT.ETH' | 'GRT' | 'LINK.ETH' | 'USDP.SOL' | 'ZK.ZKSYNC' | 'BONK.SOL' | 'KNC' | 'TIA' | 'ZRO.ETH' | 'ZRX.ETH' | 'PUMP.SOL' | 'USD' | 'XTZ' | 'CRV.ETH' | 'GALA.ETH' | 'TON' | 'USDT.POLYGON' | 'WBTC.ETH' | 'XPL' | 'BTC' | 'MON' | 'SHIB.ETH' | 'USDC.BSC' | 'WLD.WORLDCHAIN' | 'W.SOL' | 'LTC' | 'RLUSD.ETH' | 'WBTC' | 'LINK' | 'USDCX.CANTON' | 'ETH' | 'WIF.SOL' | 'APE.ETH' | 'EURC' | 'MKR.ETH' | 'RLUSD.XRP' — The underlying asset in the trading pair. E.g. `BTC` in the pair `BTC/USD`.

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved paginated list of transfers with optional filters: page, page_size, to_participant_code, from_participant_code, requested_timestamp filters, client_transfer_id.

- GetTransfersResponse
  - `message` TransferEntity[]
    - `id` number — The transfer request ID.
    - `created_at` string, date-time — ISO 8601 timestamp when the transfer request was created.
    - `updated_at` string, date-time — ISO 8601 timestamp when the transfer request was last updated.
    - `status` 'pending' | 'approved' | 'canceled' | 'rejected' | 'settled' | 'outstanding' | 'error_canceled' — The current status of the transfer request: - `pending`: platform submitted and awaiting approval via the customer portal. - `approved`: platform submitted and approved. Transfers created via this API are auto-set to `approved`. - `rejected`: transfer was declined by an administrator. - `settled`: transfer has been successfully completed. - `outstanding`: transfer has no funds available. - `canceled`: transfer was canceled. - `error_canceled`: transfer failed. Note: pre-funded transfers can only be `approved`, `settled`, or `rejected`.
    - `from_participant_code` string — The source participant for the transfer, e.g. `ABCDEF`.
    - `from_account_group` string, nullable — The source account group for the transfer, e.g. `ABCDEF`. Null when the requesting participant is not authorized to see the source account group.
    - `from_account_label` string, nullable — The source account label for the transfer, e.g. `general`. Null when the requesting participant is not authorized to see the source account label.
    - `to_participant_code` string — The destination participant for the transfer, e.g. `ABCDEF`.
    - `to_account_group` string, nullable — The destination account group for the transfer, e.g. `ABCDEF`. Null when the requesting participant is not authorized to see the destination account group.
    - `to_account_label` string, nullable — The destination account label for the transfer, e.g. `general`. Null when the requesting participant is not authorized to see the destination account label.
    - `asset` string — The asset code for the transfer, e.g. `USD`.
    - `amount` string — The amount or quantity transferred, e.g. `100`.
    - `movement_id` string, nullable — A unique ID for the ledger movement associated with the transfer. Null until the transfer reaches `settled`.
    - `client_transfer_id` string — A unique identifier for the transfer. Must be unique per platform, per 72 hour period.
    - `admin_transfer` boolean — Indicates whether the transfer was created by an administrator. Transfers created via this API are always `false`.
    - `parent_link_id` string, nullable — Identifier linking this transfer to a parent operation (e.g. a prefunded transfer chain). Null when the transfer is not linked.
    - `parent_link_id_source` string, nullable — Source of the `parent_link_id`. Null when the transfer is not linked.
    - `prefunded` boolean — Indicates whether this transfer was created as a pre-funded transfer that is included in net settlement calculations.
  - `page` number
  - `page_size` number
  - `total_pages` number
  - `count` number

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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