Skip to main content
GET
Retrieve Virtual Account
Retrieve detailed information about a specific virtual account by its ID.

Overview

This endpoint returns comprehensive details about a single virtual account, including account information, balance, status, and metadata.

Path Parameters

string
required
Virtual account UUID

Response

object
Complete virtual account object including:
  • id: Virtual account UUID
  • account_no: Account number
  • account_name: Account holder name
  • bank_name: Bank name
  • currency_code: Currency code
  • active: Whether account is active
  • account_type: Account type (individual/business)
  • metadata: Additional metadata object
  • dob: Date of birth of account holder if account is an individual account
  • reference: Account reference
  • rc_number: RC Number if account is a corporate/business account
  • corporate_account_type: Corporate account type if account is a corporate/business account
  • status: Status of account. Can be pending, active or failed
  • created_at: Creation timestamp

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API key in the Authorization header as: Bearer {your_api_key}

Path Parameters

id
string<uuid>
required

Virtual account ID

Response

200 - application/json

Virtual account retrieved successfully

success
boolean
message
string
stan
string<uuid>
data
object