Get Detail Virtual Account

Endpoint: GET /v2/gc/virtual-accounts/{virtualAccountRequestId}

Description: Retrieve the current status and bank details of a virtual account application.

Request

Request Body Field Descriptions (JSON)

Field Name	Type	Required	Description
N/A	N/A	N/A	GET request does not require a JSON body.

Request sample

// No request body required for this GET endpoint.

Response

Response Field Descriptions

Field Name	Type	Description
code	number	Response code.
state	number	State of the response.
data	object	Virtual account detail.
message	string	Response message.
neoResponseId	string	Unique NeoX response identifier.

data object fields:

Field Name	Type	Description
virtualAccountRequestId	string	NeoX identifier for this virtual account application.
status	string	Current application status. Enum: INIT, PROCESSING, SUCCESS.
vaNumber	string	Assigned virtual account number. Populated after the account is approved.
vaName	string	Assigned virtual account name. Populated after the account is approved.
currency	string	Currency or currencies associated with the virtual account.
vaArea	string	Geographic area or jurisdiction of the virtual account.
openBankCode	string	Code of the bank where the virtual account is held.
openBankName	string	Name of the bank where the virtual account is held.
openBankAddress	string	Address of the bank where the virtual account is held.
openBankSwiftCode	string	SWIFT/BIC code of the bank where the virtual account is held.
openBankBranchCode	string	Branch code of the bank where the virtual account is held.
localBankRouteNo	string	Local bank routing number (e.g. ABA for the US, sort code for the UK).
createdAt	date string	Timestamp when the virtual account application was created (ISO 8601).
updatedAt	date string	Timestamp of the most recent status update (ISO 8601).

Response sample

{
  "code": 1,
  "state": 2,
  "data": {
    "virtualAccountRequestId": "VA-20240301-00012345",
    "status": "SUCCESS",
    "vaNumber": "HK8801234567890",
    "vaName": "Acme Trading Limited",
    "currency": "USD,EUR,HKD",
    "vaArea": "HK",
    "openBankCode": "HSBCHKHH",
    "openBankName": "HSBC Hong Kong",
    "openBankAddress": "1 Queen's Road Central, Hong Kong",
    "openBankSwiftCode": "HSBCHKHH",
    "openBankBranchCode": "004",
    "localBankRouteNo": "004-123456",
    "createdAt": "2024-03-01T08:00:00Z",
    "updatedAt": "2024-03-02T14:30:00Z"
  },
  "message": "Successful",
  "neoResponseId": "de7750c5-772e-4136-ac78-62c57a106cce"
}

Example cURL

curl -X GET "https://{base_url_openapi}/v2/gc/virtual-accounts/{virtualAccountRequestId}" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en"

Notes

• Requires Bearer token in the Authorization header.

• The Accept-Language header can be used to specify the response language (Support: "vi", "en").

• No request body required.

• Replace {virtualAccountRequestId} with the actual virtual account request ID returned by the Create Virtual Account API.

• Use this endpoint to poll the application status when a webhook is not yet received or to retrieve the latest bank details after status becomes SUCCESS.