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

# List Transfers

`GET /v1/transfers`

Lists merchant-initiated transfers for the authenticated merchant. Transfer webhook events use the transfer.* namespace.

## Query parameters

- `limit` integer
- `page` integer
- `status` 'PROCESSING' | 'SETTLED' | 'FAILED'
- `currency` 'NGN' | 'USD' | 'SOL' | 'BNB'

## Response `200`

OK

- ListTransfersResponse
  - `data` TransferResponse[]
    - `amount` string
    - `created_at` string
    - `currency` string
    - `debit_amount` string
    - `debit_currency` string
    - `debit_scope` string
    - `fee` string
    - `flag_reason` string
    - `id` string
    - `on_behalf_of` OnBehalfOfReq
      - `customer_id` string, required
    - `rail` string
    - `rate` TransferRateResponse
      - `captured_at` string
      - `side` string
      - `value` string
    - `recipient` RecipientResponse
      - `bank_account` BankAccountResponse
        - `account_name` string
        - `account_number_last4` string
        - `bank_code` string
        - `bank_name` string
      - `created_at` string
      - `crypto_address` CryptoAddressResponse
        - `address` string
        - `asset` string
        - `chain` string
      - `first_name` string
      - `id` string
      - `last_name` string
      - `swift_bank_account` SWIFTBankAccountResponse
        - `account_country` string
        - `account_owner_name` string
        - `account_owner_type` string
        - `address` RecipientAddressInput
          - `city` string, required
          - `country` string, required
          - `postal_code` string, required
          - `state` string
          - `street_line_1` string, required
          - `street_line_2` string
        - `bank_address` RecipientAddressInput
          - `city` string, required
          - `country` string, required
          - `postal_code` string, required
          - `state` string
          - `street_line_1` string, required
          - `street_line_2` string
        - `bank_name` string
        - `bic` string
        - `business_name` string
        - `category` string
        - `first_name` string
        - `iban_last4` string
        - `last_name` string
        - `purpose_of_funds` string[]
        - `short_business_description` string
      - `type` string
      - `us_bank_account` USBankAccountResponse
        - `account_number_last4` string
        - `account_owner_name` string
        - `account_type` string
        - `address` RecipientAddressInput
          - `city` string, required
          - `country` string, required
          - `postal_code` string, required
          - `state` string
          - `street_line_1` string, required
          - `street_line_2` string
        - `bank_name` string
        - `payout_scheme` string
        - `routing_number` string
    - `reference` string
    - `settled_at` string
    - `status` string
  - `limit` integer
  - `page` integer
  - `total` integer
  - `total_pages` integer

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)