---
title: "List Virtual Accounts"
method: GET
path: "/virtual_accounts"
tags: ["Virtual Accounts"]
---

# List Virtual Accounts

`GET /virtual_accounts`

List all Virtual Account objects

## Query parameters

- `status` 'activated' | 'deactivated' — The activation status of the Virtual Account
- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

List of Virtual Accounts

- object
  - `count` integer, required — total number of items in data
  - `data` VirtualAccountResponse[], required
    - `id` string — A UUID that uniquely identifies a resource
    - `status` 'activated' | 'deactivated' — The activation status of the Virtual Account
    - `developer_fee_percent` string, number — The developer fee percent that will be applied to this Virtual Account. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API.
    - `fee_config` FeeConfigResponse — Developer fee configuration. Available by request only. Contact Bridge to enable this feature for your developer account. Responses render source-side fees keyed by payment rail, using `default` for a catch-all configuration.
      - `source` object — Source-side fee configuration keyed by payment rail or `default`
    - `customer_id` string — A UUID that uniquely identifies a resource
    - `created_at` string, date-time — Time of creation of the virtual account
    - `source_deposit_instructions` union
      - VirtualAccountSourceDepositInstructionsUs
        - `bank_account_number` string, required — The account number of the bank that the customer should send the deposit to
        - `bank_routing_number` string, required — The routing number of the bank that the customer should send the deposit to
        - `bank_beneficiary_name` string, required — If available, the name of the beneficiary of the bank account that the customer should send the deposit to
        - `bank_beneficiary_address` string, required — If available, the address of the beneficiary of the bank account that the customer should send the deposit to
        - `currency` 'usd', required
        - `payment_rail` 'ach_push' | 'bre_b' | 'faster_payments' | 'pix' | 'sepa' | 'spei' | 'wire'
        - `payment_rails` string[], required — The payment rails supported by these deposit instructions
        - `bank_name` string, required — The name of the bank that the customer should send the deposit to
        - `bank_address` string, required — The address of the bank that the customer should send the deposit to
      - VirtualAccountSourceDepositInstructionsEu
        - `iban` string, required — he IBAN of the account that the customer should send the deposit to
        - `bic` string, required — The BIC of the bank that the customer should send the deposit to
        - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to.
        - `currency` 'eur', required
        - `payment_rails` 'sepa', required
        - `bank_name` string, required — The name of the bank that the customer should send the deposit to
        - `bank_address` string, required — The address of the bank that the customer should send the deposit to
      - VirtualAccountSourceDepositInstructionsMx
        - `clabe` string, required — The CLABE (account number) of the account that the customer should send the deposit to
        - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to.
        - `currency` 'mxn', required
        - `payment_rails` string[], required — The payment rails supported by these deposit instructions
        - `bank_name` string, required — The name of the bank that the customer should send the deposit to
        - `bank_address` string, required — The address of the bank that the customer should send the deposit to
      - VirtualAccountSourceDepositInstructionsBr
        - `br_code` string, required — The BR Code that the customer should send the deposit to
        - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to.
        - `currency` 'brl', required
        - `payment_rails` string[], required — The payment rails supported by these deposit instructions
        - `bank_name` string, required — The name of the bank that the customer should send the deposit to
        - `bank_address` string, required — The address of the bank that the customer should send the deposit to
      - VirtualAccountSourceDepositInstructionsGb
        - `account_number` string, required — The bank account number
        - `sort_code` string, required — The sort code, without hyphens
        - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to.
        - `currency` 'gbp', required
        - `payment_rails` 'faster_payments', required
        - `bank_name` string, required — The name of the bank that the customer should send the deposit to
        - `bank_address` string, required — The address of the bank that the customer should send the deposit to
      - VirtualAccountSourceDepositInstructionsCo
        - `bre_b_key` string, required — The Bre-B key of the Colombian bank account for receiving COP deposits
        - `account_holder_name` string, required — The name of the account owner that the deposit must be sent to.
        - `deposit_message` string — The reference message to include with the COP deposit
        - `currency` 'cop', required
        - `payment_rails` string[], required — The payment rails supported by these deposit instructions
        - `bank_name` string, required — The name of the bank that the customer should send the deposit to
        - `bank_address` string, required — The address of the bank that the customer should send the deposit to
    - `destination` VirtualAccountDestination
      - `currency` 'usdb' | 'usdc' | 'usdt' | 'pyusd' | 'eurc', required
      - `payment_rail` 'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tempo' | 'tron', required
      - `address` string — The crypto wallet address that the customer wishes to ultimately receive funds at
      - `blockchain_memo` string — The memo to include when sending funds on chain. Only allowed for blockchains that support memos such as Stellar
      - `bridge_wallet_id` string — A UUID that uniquely identifies a resource
      - `prefunded_account_id` string — A UUID that uniquely identifies a resource

---

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