Retrieve a virtual account created by your business. The path value can be the virtual account ID or the account number.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/wallets/{accountNumberOrAccountId}

Path Parameters

Field	Data Type	Required	Description
accountNumberOrAccountId	string	Yes	Virtual account number or virtual account ID.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "id": "89d8f903-96f6-48df-af97-1f2b3bb64260",
    "accountNumber": "1234567890",
    "accountName": "KYSHI / ADA OKAFOR",
    "bankCode": "999999",
    "bankName": "Provider Bank",
    "balance": 5000,
    "active": true,
    "mode": "live",
    "accountCategory": "VIRTUAL_ACCOUNT",
    "accountType": "INDIVIDUAL",
    "reference": "VA_123456789",
    "provider": "VFD",
    "createdAt": "2026-05-20T10:15:00.000Z"
  }
}