List Virtual Accounts

Overview

Get a list of all VAs (Virtual Accounts) created.

Resource Access

• HTTP Method: GET
• Endpoint: /banking/iban/api/virtual-account/v2/list
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Accept	application/json	Yes	Content type for the response
Authorization	Bearer {access_token}	Yes	Bearer token for authentication
on-behalf-of	string	No	Customer ID when operating on behalf of your customer

Response

Success Response (200 OK)

{
  "accounts": [
    {
      "biz_id": "VA202501142006502111",
      "currency": "USD",
      "bank_location": "US",
      "account_purpose": "02",
      "status": "APPROVED",
      "account_number": "1234567890",
      "routing_number": "021000021",
      "swift_code": "CHASUS33",
      "balance": 10000.50,
      "created_at": "2026-01-14T10:00:00.000Z"
    },
    {
      "biz_id": "VA202501142006502112",
      "currency": "EUR",
      "bank_location": "DE",
      "account_purpose": "02",
      "status": "APPROVED",
      "account_number": "DE89370400440532013000",
      "swift_code": "COBADEFF",
      "balance": 5000.00,
      "created_at": "2026-01-13T10:00:00.000Z"
    }
  ],
  "total_count": 2
}

Response Fields

Field	Type	Description
accounts	array	Array of virtual account objects
total_count	integer	Total number of virtual accounts

Account Object Fields

Field	Type	Description
biz_id	string	Unique virtual account identifier
currency	string	Currency code
bank_location	string	Bank location country code
account_purpose	string	Purpose code
status	string	Account status
account_number	string	Virtual account number
routing_number	string	Routing number (if applicable)
swift_code	string	SWIFT/BIC code
balance	number	Current balance
created_at	string (date-time)	Creation timestamp

Error Responses

• 401 Unauthorized: Invalid or missing authentication token
• 403 Forbidden: Not authorized to view accounts

Code Examples

cURL

curl -X GET \
  'https://gateway.ahrvo.network/banking/iban/api/virtual-account/v2/list' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Python

import requests

url = "https://gateway.ahrvo.network/banking/iban/api/virtual-account/v2/list"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://gateway.ahrvo.network/banking/iban/api/virtual-account/v2/list';
const headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
};

axios.get(url, { headers })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response.data);
  });

Usage Notes

• All virtual accounts for the authenticated user/customer are returned
• Use on-behalf-of header when operating on behalf of a customer
• Filter results on client side if needed
• Account balances are real-time
• Closed accounts are not included in the list

Interactive API Explorer