---
title: "Child Address Account Create"
method: POST
path: "/v2/wallets/{walletId}/addresses/{addressId}/virtual-accounts"
tags: ["Virtual Accounts V2"]
---

# Child Address Account Create

`POST /v2/wallets/{walletId}/addresses/{addressId}/virtual-accounts`

## Request

- Base URL: `https://api.blockradar.co`
- URL: `https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/virtual-accounts`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/blockradar/apis/blockradar-documentation/docs/v2/wallets/:walletId/addresses/:addressId/virtual-accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `walletId` string, uuid, required
- `addressId` string, uuid, required

## Request body

- CreateVirtualAccountV2Dto
  - `currency` string, required: ISO 4217 virtual-account currency.
  - `assetId` string, uuid: Stablecoin asset that receives settlements.
  - `customerId` string, uuid: Existing customer identifier, when the provider requires one.
  - `additionalData` object: Values collected and validated against additionalDataSchema.
  - `code` string
  - `passkeyResponse` object
  - `label` string: Your display label for the virtual account.
  - `provider` string, required: Provider slug resolved from the requirements flow.

## Response `201`

Created successfully.

- VirtualAccountCreateResponse
  - `statusCode` integer, required
  - `message` string, required: Human-readable result.
  - `data` VirtualAccountCreateResult, required
    - `created` boolean, required
    - `virtualAccount` VirtualAccount, required
      - `id` string, uuid, required: Virtual account identifier.
      - `reference` string, required: Blockradar virtual-account reference.
      - `accountNumber` string, required: Bank account number.
      - `accountName` string, required: Bank account holder name.
      - `bankName` string, required: Bank name.
      - `bankCode` string, required: Bank or institution code.
      - `currency` string, required: ISO 4217 account currency.
      - `institutionAddress` string, nullable: Institution address.
      - `assetId` string, uuid, required: Stablecoin asset settled to the wallet.
      - `providerId` string, uuid, required: Provider identifier.
      - `isActive` boolean, required
      - `status` string, required: Provider-normalized account status.
      - `type` string, required: Virtual account behavior.
      - `label` string, nullable: Customer-defined label.
      - `createdAt` string, date-time, required: Creation timestamp.
      - `updatedAt` string, date-time, required: Last update timestamp.

---

[API](https://skmtc.dev/blockradar/apis/blockradar-documentation.md) - [All operations](https://skmtc.dev/blockradar/apis/blockradar-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/blockradar/apis/blockradar-documentation/revisions/97f95b4cfc0d?raw)