v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Virtual Accounts V2

List Virtual Accounts

get/v2/wallets/{id}/virtual-accounts

Path parameters

idstring uuid required

Wallet identifier.

Query parameters

isActiveboolean

Filter virtual accounts by activation state.

searchstring

Search by reference, label, account name, or account number.

startDatestring date-time

Inclusive ISO 8601 start date. Required only when endDate is supplied.

endDatestring date-time

Inclusive ISO 8601 end date. Required only when startDate is supplied.

pageinteger

One-based page number.

limitinteger

Records per page. Maximum 100.

Response

Successful response.

statusCodeinteger required

messagestring required

Human-readable result.

Example response

{
  "statusCode": 200,
  "message": "Virtual accounts fetched successfully",
  "data": [
    {
      "id": "3e8fcd73-4067-4386-8c1e-9929e6a768d7",
      "reference": "va_01J2X8JQ4V9N0P7K2M6C3F5R8T",
      "accountNumber": "0123456789",
      "accountName": "Acme Ltd / Ada Okafor",
      "bankName": "Example Bank",
      "bankCode": "999",
      "currency": "NGN",
      "assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
      "providerId": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
      "isActive": true,
      "status": "active",
      "type": "AUTO_FUNDING",
      "label": "Ada collection account",
      "createdAt": "2026-07-19T12:30:00.000Z",
      "updatedAt": "2026-07-19T12:30:00.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 10,
    "pageCount": 1
  },
  "links": {
    "first": "https://api.blockradar.co/v1/example?page=1&limit=10",
    "last": "https://api.blockradar.co/v1/example?page=1&limit=10"
  }
}