v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Virtual Accounts V2

Child Address Account Regenerate

post/v2/wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/regenerate

Path parameters

walletIdstring uuid required

Wallet identifier.

addressIdstring uuid required

Child address identifier.

virtualAccountIdstring uuid required

Virtual account identifier.

Request body

currencystring required

reasonstring required

Reason a replacement account is required.

assetIdstring uuid

customerIdstring uuid

additionalDataobject

codestring

passkeyResponseobject

labelstring

providerstring required

Example request

{
  "reason": "The previous account was closed by the institution."
}

Response

Created successfully.

statusCodeinteger required

messagestring required

Human-readable result.

Example response

{
  "statusCode": 200,
  "message": "Virtual account fetched successfully",
  "data": {
    "id": "3e8fcd73-4067-4386-8c1e-9929e6a768d7",
    "reference": "va_01J2X8JQ4V9N0P7K2M6C3F5R8T",
    "accountNumber": "0123456789",
    "accountName": "Acme Ltd / Ada Okafor",
    "bankName": "Example Bank",
    "bankCode": "999",
    "currency": "NGN",
    "assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
    "providerId": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
    "isActive": true,
    "status": "active",
    "type": "AUTO_FUNDING",
    "label": "Ada collection account",
    "createdAt": "2026-07-19T12:30:00.000Z",
    "updatedAt": "2026-07-19T12:30:00.000Z"
  }
}