List Virtual Accounts
Accounts
List Virtual Accounts
Retrieve a paginated list of all virtual accounts associated with your account.
GET
List Virtual Accounts
Retrieve a paginated list of all virtual accounts associated with your account.
Overview
This endpoint returns all virtual accounts you’ve created, allowing you to view their status, account numbers, and balances.Query Parameters
integer
Page number for pagination (default: 1)
integer
Number of items per page (default: 10)
Response
object
Paginated response containing:
total_pages: Total number of pagescurrent_page: Current page numbertotal_records: Total number of virtual accountsnext_page: URL for next pageprevious_page: URL for previous pageitems: Array of virtual account objects
object
Each virtual account object includes:
id: Virtual account UUIDaccount_no: Account numberaccount_name: Account holder namebank_name: Bank namecurrency_code: Currency codeactive: Whether account is activedob: Date of birth of account holder if account is an individual accountreference: Account referenceaccount_type: Account typerc_number: RC Number if account is a corporate/business accountcorporate_account_type: Corporate account type if account is a corporate/business accountstatus: Status of account. Can be pending, active or failedmetadata: Additional metadatacreated_at: Creation timestamp
Authorizations
Bearer token authentication. Include your API key in the Authorization header as: Bearer {your_api_key}
Query Parameters
Page number for pagination
Number of items per page