Skip to main content
Use this endpoint to look up the latest data for a static or dynamic virtual account. It returns the account number, status, expiry information, and the customer profile you attached during creation.

Endpoint

GET {{baseURL}}/v1/virtual-account/{virtualAccountId}

Request headers

Path parameters

You can obtain the virtualAccountId from the response of the static or dynamic account creation endpoints.

Request examples

Successful response

copy

Response fields

Error responses

Usage tips

  • Use this endpoint to refresh the account status before showing details to a customer-facing UI.
  • Combine it with payment webhooks to confirm final settlement timestamps for reconciliation.
  • Archive or anonymise responses containing PII according to your data retention policy.