Skip to main content
GET
List Virtual Accounts
Retrieve the active virtual accounts your business can receive payments into. Filter by currency or account type.

Example Request

Query Parameters

Example Response

Fields that are empty for an account are left out, so a fiat account carries bank details while a crypto account carries wallet_address, wallet_chain and stablecoin_type instead. USD accounts also carry routing_number, swift_code and bank_address, and a dynamic account carries expires_at.
Static virtual accounts are permanent and can receive multiple payments. Dynamic virtual accounts are created for a specific amount and expire after use.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Query Parameters

currency
string

Filter by currency code, 3 or 4 characters. Matched case-insensitively.

Required string length: 3 - 4
Example:

"NGN"

virtualAccountType
enum<string>
default:static

Filter by account type. Defaults to static when omitted.

Available options:
static,
dynamic

Response

Virtual accounts retrieved successfully

status
integer
required
Example:

200

message
string
required
Example:

"Virtual accounts retrieved successfully"

success
boolean
required
Example:

true

data
object
required