v1

latestOpenAPI 3.1.02026-07-26460218.4 KB

List Virtual Accounts

Retrieves paginated list of virtual bank accounts for the authenticated partner

get/virtual-accounts/

Query parameters

currencystring

Filter by currency (e.g., USD, NGN)

status'PENDING' | 'ACTIVE' | 'CLOSED' | 'FROZEN'

Filter by account status

accountType'primary' | 'subwallet'

Filter between primary and fiat subwallet accounts (linked to a sub-wallet via subwalletId).

pageSizeinteger

Number of results per page (default 15, max 100)

cursorstring

Pagination cursor for fetching next page

Response

Example response

{
  "virtualAccounts": [
    {
      "id": "4e6b711b-8952-4f83-a2ac-cff122082cb2",
      "provider": "erebor",
      "currency": "USD",
      "accountNumber": "37212851507366",
      "routingNumber": "125109161",
      "accountName": "Efe Cashflow Business Checking",
      "bankName": "Erebor Bank",
      "status": "ACTIVE",
      "depositInstructions": {
        "swift": {
          "memoTemplate": "FFC <account holder name> <account number>",
          "memo": "FFC Efe Cashflow Business Checking 37212851507366",
          "bankName": "Erebor Bank. N.A",
          "accountNumber": "2908175093",
          "bic": "CHASUS33",
          "bankAddress": "500 Neil Ave, Ste 140 Columbus, OH 43215 US"
        }
      },
      "virtualAccountType": "third_party",
      "recordType": "viban",
      "createdAt": "2026-07-14T18:10:59.033Z",
      "updatedAt": "2026-07-14T18:10:59.033Z"
    }
  ],
  "pagination": {
    "pageSize": 5,
    "total": 1
  }
}