---
title: "List a customer's virtual accounts"
method: GET
path: "/v1/customers/{customerId}/virtual_accounts"
tags: ["Virtual Accounts"]
---

# List a customer's virtual accounts

`GET /v1/customers/{customerId}/virtual_accounts`

## Request

- Base URL: `https://api.sandbox.alfredpay.io`
- URL: `https://api.sandbox.alfredpay.io/v1/customers/{customerId}/virtual_accounts`
- Auth: one of:
  - HTTP bearer
  - API key in header `api-key` and API key in header `api-secret`

Returns every instrument issued to this customer. More than one is normal, and `label` is how you tell them apart.

## Query parameters

- `status` 'active' | 'suspended' | 'migrating' | 'closed'
- `purpose` 'CONVERSION' | 'BALANCE' | 'PAYMENT': On a virtual account it routes every deposit. On the customer profile (plural) it is the declared intent that gates which may be created.
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `has_more` boolean
  - `next_cursor` string, nullable
  - `data` VirtualAccount[]
    - `id` string
    - `customerId` string
    - `purpose` 'CONVERSION' | 'BALANCE' | 'PAYMENT': On a virtual account it routes every deposit. On the customer profile (plural) it is the declared intent that gates which may be created.
    - `currency` 'USD' | 'HKD' | 'CNY' | 'MXN' | 'DOP' | 'COP' | 'BRL' | 'ARS' | 'CLP' | 'PEN' | 'BOB' | 'PYG' | 'USDC' | 'USDT': Fourteen members, reconciled to the countries a customer can be onboarded in. USDC and USDT are stablecoins and require `chain`.
    - `label` string
    - `status` 'active' | 'suspended' | 'migrating' | 'closed'
    - `instructions` object
      - `beneficiary_name` string: The customer's own legal name.
      - `ach` object
        - `routing_number` string
        - `account_number` string
      - `wire` object
        - `routing_number` string
        - `account_number` string
        - `bank_name` string
        - `bank_address` string
      - `swift` object
        - `bic` string
        - `account_number` string
    - `destination` object: Fixed at creation.
      - `asset` string
      - `chain` 'SOL' | 'ETH' | 'MATIC' | 'BASE' | 'ARB' | 'OP' | 'AVAX' | 'BNB' | 'TRX' | 'XLM' | 'CELO'
    - `createdAt` string, date-time

## Changes

- **2026-11-03** `20fef4fd2ab3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/changes/v1/customers/:customerId/virtual_accounts/get.md)

---

[API](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation.md) - [All operations](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/alfredpay/apis/alfred-penny-api-client-documentation/revisions/20fef4fd2ab3?raw)