Virtual Accounts

Get virtual accounts

Changed on Oct 2, 2026

Retrieve the list of virtual accounts for a business. Results are paginated using cursor-based pagination and ordered by creation date (newest first).

get/v1/virtual-accounts

Request

Base URL
https://api.hit-pay.com
URL
https://api.hit-pay.com/v1/virtual-accounts
Auth
none declared. Required headers: X-BUSINESS-API-KEY

Query parameters

cursorstring nullable

Cursor for pagination

per_page5 | 10 | 20 | 25 | 50 | 100

Number of results per page

bank_countrystring

Only return virtual accounts held in this bank country (two-letter lowercase ISO 3166-1 code, e.g. sg)

status'open' | 'closed'

Only return open or closed virtual accounts. A closed account is one that has been closed; this is separate from the status field in the response, which is the provisioning status. Omit to return both.

Headers

X-BUSINESS-API-KEYstring required

Example:b286daabf9921b5a01a4621f026c111e046f8911feba212996c92159b98427d

Response

Successful operation

Example response

{
  "data": [
    {
      "id": "9b3f1a2c-1d4e-4f6a-8b2c-7e9d0a1b2c3d",
      "name": "Acme Pte Ltd",
      "reference": "1234567",
      "status": "success",
      "country": "sg",
      "supported_currencies": [
        "SGD",
        "USD"
      ],
      "holder_name": "Acme Pte Ltd",
      "account_number": "8854911234567",
      "bank_name": "DBS Bank",
      "bank_swift_code": "DBSSSGSG",
      "bank_country": "sg",
      "bank_attributes": {
        "type": "local",
        "account_number": "8854911234567",
        "bank_name": "DBS Bank",
        "swift_code": "DBSSSGSG",
        "transfer_types": [
          "FAST",
          "SWIFT"
        ]
      },
      "transfer_types": [
        "FAST",
        "SWIFT"
      ],
      "created_at": "2026-06-08T15:30:10+08:00",
      "updated_at": "2026-06-08T15:30:10+08:00"
    }
  ]
}

Changes

Oct 2, 20261aa635b1fa84 Revision changes
- info
  added the new optional query request parameter bank_country
- info
  added the new optional query request parameter status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
Sep 7, 2026dbf5c86cb44c Revision changes
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history