Retrieve individual VA customer
Authentication
Virtual Account APIs use the same access token as the rest of the platform. Obtain it from the Authentication API and send it on every VA call:
Authorization: Bearer <access_token>
Base URLs for each environment are listed under API environments.
note
What this does: Re-fetches the full customer record by code — everything you sent on Create, plus system-computed fields such as screening status and Virtual Account currency assignment.
Endpoint
GET
/ewallet/api/v1/customer-registration/{code}- Path Parameter — REQUIRED
code— thecustomerRegistration.codereturned by Create
Additional Fields in the Response
| Field | Notes |
|---|---|
| customerId | System-generated unique customer identifier, e.g. 100000909313824I |
| fullName / nickName / tradeName | Derived display names |
| screeningStatus | AML screening state, e.g. IP (in progress) |
| customerStatus / customerState / customerStateCode | Lifecycle status, e.g. Active / System Approved / AA |
| virtualAccountCurrencyCodes / virtualAccountCurrencyName | Currencies this customer's VA is provisioned for, e.g. EUR, USD-USA, GBP |
| provider | KYC/screening provider used, e.g. AiPrise |
| registrationApprovedBy / creationDate / createdBy | Audit trail fields |
info
Response shape is identical to the Business Customer Receipt (Retrieve business VA customer), just without the ownerDetailList array.