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

# GET /api/v1/transfers

`GET /api/v1/transfers`

List all transfers for a tenant with optional filtering by status, type, and customer_id

## Query parameters

- `status` 'CREATED' | 'UNKNOWN' | 'COMPLIANCE_HOLD' | 'AWAITING_FUNDS_COLLECTION' | 'FUNDS_COLLECTED' | 'IN_PROGRESS' | 'PAYMENT_SUBMITTED' | 'PAYMENT_PROCESSED' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'EXPIRED', required — Status of the transfer: CREATED (initial state), UNKNOWN (deprecated internal status), AWAITING_FUNDS_COLLECTION, FUNDS_COLLECTED, IN_PROGRESS (funds received, internal processing), PAYMENT_SUBMITTED, PAYMENT_PROCESSED, COMPLETED (succeeded), FAILED (failed permanently), CANCELLED (manually cancelled), EXPIRED (expired before completion)
- `type` 'TRANSFER_TYPE_OFFRAMP' | 'TRANSFER_TYPE_ONRAMP', required — Type of transfer: OFFRAMP (crypto to fiat) or ONRAMP (fiat to crypto)
- `customer_id` string, uuid
- `page_size` integer
- `page_token` string

## Response `200`

Default Response

- object — Response schema for listing transfers
  - `transfers` TransferResponse[], required
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `customer_id` string, uuid, required
    - `quote_id` string, uuid, required
    - `type` 'offramp' | 'onramp', required — Type of transfer: offramp (crypto to fiat) or onramp (fiat to crypto)
    - `status` 'created' | 'unknown' | 'compliance_hold' | 'awaiting_funds_collection' | 'funds_collected' | 'in_progress' | 'payment_submitted' | 'payment_processed' | 'completed' | 'failed' | 'cancelled' | 'expired', required — Status of the transfer in display format
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `metadata` Metadata
    - `source_deposit_instructions` union
      - object
        - `wallet_address` string, required — Unique wallet address for this payment intent
        - `currency` string, required — Currency or token code (e.g., 'USDC', 'USDT')
        - `network` string, required — Blockchain network
        - `amount` string, required — Expected stablecoin amount in major units
      - object
        - `bank_name` string — Bank name for fiat deposit
        - `account_number` string — Bank account number
        - `iban` string — International Bank Account Number
        - `bic` string — Bank Identifier Code
        - `payment_rails` string[]
        - `bsb` string — BSB routing number (Australia)
        - `account_name` string — Account holder name
        - `reference` string — Payment reference
        - `currency` string, required — Fiat currency code
        - `amount` string, required — Expected fiat amount in major units
    - `destination` union
      - object
        - `amount` string, required — Destination amount in major units
        - `currency` string, required — Destination currency code
        - `network` string, required — Blockchain network
        - `wallet_address` string, required — Destination wallet address
      - object
        - `amount` string, required — Destination amount in major units
        - `currency` string, required — Destination currency code
        - `network` string, required
        - `account_holder_name` string
        - `account_number` string
        - `iban` string
        - `bank_name` string
        - `bank_country` string
        - `account_type` 'savings' | 'checking' | 'payment' — Type of bank account
        - `branch_name` string
        - `address` AddressApiOutput
          - `street` string, required
          - `city` string, required
          - `state` string, required
          - `postal_code` string, required
          - `country` string, required — Country code (ISO 3166-1 alpha-2, lowercase)
        - `swift_code` string
        - `bic_code` string
        - `ifsc_code` string
        - `aba_code` string
        - `sort_code` string
        - `branch_code` string
        - `bsb_code` string
        - `bank_code` string
        - `cnaps` string
        - `name_in_local_language` string
        - `national_identification_number` string
        - `logistics_tracking_details` object[]
          - `tracking_number` string
          - `logistics_provider` object
            - `name` string
            - `code` string
        - `documents` object[]
          - `type` 'invoice' | 'contract' | 'other'
    - `fees` object, nullable
      - `fx_fee` object
        - `amount` string, required
        - `currency` string, required
      - `integrator_fee` object
        - `amount` string, required
        - `currency` string, required
      - `platform_fee` object
        - `amount` string, required
        - `currency` string, required
      - `payment_method_fee` object
        - `amount` string, required
        - `currency` string, required
      - `network_fee` object
        - `amount` string, required
        - `currency` string, required
      - `total_fee` object
        - `amount` string, required
        - `currency` string, required
    - `exchange_rate` number, nullable
    - `origin` 'api' | 'otc', required
  - `page` object, required
    - `next_page_token` string, required
    - `total` integer, required

---

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