Sign in

v1

latestOpenAPI 3.0.32026-07-26184851.6 MB
Virtual Accounts V2

Child Address List

get/v2/wallets/{walletId}/addresses/{addressId}/virtual-accounts

Path parameters

walletIdstring uuid required

Wallet identifier.

addressIdstring uuid required

Child address 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"
  }
}