List virtual accounts

API: POST /v1/bank/get-va-paging

Queries the list of virtual accounts (VAs) you have created, with pagination and filtering by multiple criteria.

Usage

Node.js

const result = await client.bank.getVaPaging({
  skipCount: 0,
  maxResultCount: 10,
});

Java

var req = new OpenApiGetVaPagingDto();
req.setSkipCount(0);
req.setMaxResultCount(10);

var result = client.bank.getVaPaging(req);

C#

var result = await client.Bank.GetVaPagingAsync(new OpenApiGetVaPagingDto
{
    SkipCount = 0,
    MaxResultCount = 10,
});

PHP

$result = $client->bank->getVaPaging(skipCount: 0, maxResultCount: 10);

Parameters

Field	Type	Required	Description
skipCount	number	✓	Number of records to skip (e.g. 0 for the first page)
maxResultCount	number	✓	Maximum number of records per page (e.g. 10)
filter	string	✕	Search keyword (by name or account number)
merchantId	number	✕	Merchant ID (required when calling via Master Merchant)
bankBin	string	✕	Filter by bank BIN
accountType	string	✕	Filter by type: personal-account, business-account, business-household-account

Response

{
  "code": "00",
  "message": "Success",
  "data": {
    "totalCount": 1,
    "items": [
      {
        "bankBin": "970418",
        "accountName": "LE DUY NGHIEM",
        "accountNumber": "0123456789111",
        "vaAccountNumber": "VQRQAHFVA0551",
        "status": "active",
        "accountType": "personal-account",
        "creationTime": "2025-09-04T08:12:32.160Z"
      }
    ]
  }
}

Field	Type	Description
data.totalCount	number	Total number of records
data.items	array	List of VAs
data.items[].vaAccountNumber	string	Virtual account number
data.items[].status	string	VA status