---
title: "List Virtual Accounts V1"
method: GET
path: "/v1/customers/virtual-account"
tags: ["Virtual Accounts"]
---

# List Virtual Accounts V1

`GET /v1/customers/virtual-account`

Retrieve a list of all virtual accounts for a specific customer

## Query parameters

- `customer_id` string, uuid, required

## Response `200`

Virtual accounts retrieved successfully

- object
  - `data` object, required
    - `virtual_accounts` VirtualAccount[], required
      - `id` string, uuid, required
      - `status` string, required
      - `developer_fee_percent` number, required
      - `customer_id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `deposit_instructions` object, required
        - `currency` string
        - `bank_name` string
        - `bank_address` string
        - `bank_routing_number` string
        - `bank_account_number` string
        - `bank_beneficiary_name` string
        - `bank_beneficiary_address` string
        - `payment_rails` string[]
      - `destination` object, required
        - `currency` 'USDC'
        - `destination_chain` 'POLYGON' | 'ETHEREUM'
        - `address` string
    - `pagination` object, required
      - `current_page` integer
      - `per_page` integer
      - `total_page` integer
      - `total` integer

## Other responses

- `401` — Authentication failed due to invalid credentials
- `422` — Failed due to a formatting error.

---

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