Skip to main content
GET
/
accounts
/
virtual-accounts
/
{id}
Retrieve Virtual Account
curl --request GET \
  --url https://api.usepooler.com/accounts/virtual-accounts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "<string>",
  "stan": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "currency": "<string>",
    "account_number": "<string>",
    "account_name": "<string>",
    "bank_name": "<string>",
    "dob": "<string>",
    "reference": "<string>",
    "account_type": "<string>",
    "active": true,
    "status": "<string>",
    "rc_number": "<string>",
    "corporate_account_type": "<string>",
    "created_at": "2023-11-07T05:31:56Z"
  }
}
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

​
id
string
required
Virtual account UUID

​
Response

​
data
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