---
title: "Create Virtual Account"
method: POST
path: "/v2/accounts/{accountId}/virtual"
tags: ["Virtual Accounts"]
---

# Create Virtual Account

`POST /v2/accounts/{accountId}/virtual`

Creates new virtual accounts for the given owners (max 1000 owners). 
		Request body differs for individual vs company owners, and GBP vs EUR virtual accounts.
		It is possible to create virtual accounts without owner bank details - see CreateNoBankDetailsVirtualAccount schemas.
		It is not possible to make payments out of virtual accounts without owner bank details.

## Path parameters

- `accountId` number, required

## Request body

- union[]
  - union
    - CreateEURLocalVirtualAccountForCompany
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's EUR bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `registrationNumber` string — The registration number of the virtual account owner - only applicable to a corporation. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
      - `iban` string, required — The IBAN of the virtual account owner's EUR bank account
      - `bicSwift` string, required — The BIC of the virtual account owner's EUR bank account
    - CreateEURLocalVirtualAccountForIndividual
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's EUR bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `dateOfBirth` string, required — The date of birth of the virtual account owner
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
      - `iban` string, required — The IBAN of the virtual account owner's EUR bank account
      - `bicSwift` string, required — The BIC of the virtual account owner's EUR bank account
    - CreateGBPLocalVirtualAccountForCompany
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `registrationNumber` string — The registration number of the virtual account owner - only applicable to a corporation. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
      - `iban` string — The IBAN of the virtual account owner's bank account
      - `bicSwift` string — The BIC of the virtual account owner's bank account
      - `accountNumber` string, required — The 8-digit account number of the virtual account owner's bank account - mandatory for GBP accounts
      - `sortCode` string, required — The 6-digit sort code of the virtual account owner's bank account - mandatory for GBP accounts
    - CreateGBPLocalVirtualAccountForIndividual
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `dateOfBirth` string, required — The date of birth of the virtual account owner - only applicable to an individual
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
      - `iban` string — The IBAN of the virtual account owner's bank account
      - `bicSwift` string — The BIC of the virtual account owner's bank account
      - `accountNumber` string, required — The 8-digit account number of the virtual account owner's bank account - mandatory for GBP accounts
      - `sortCode` string, required — The 6-digit sort code of the virtual account owner's bank account - mandatory for GBP accounts
    - CreateInternationalVirtualAccountForCompany
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string, required — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's EUR bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `registrationNumber` string — The registration number of the virtual account owner - only applicable to a corporation. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
      - `iban` string, required — The IBAN of the virtual account owner's bank account
      - `bicSwift` string, required — The BIC of the virtual account owner's bank account
    - CreateInternationalVirtualAccountForIndividual
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string, required — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's EUR bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `dateOfBirth` string, required — The date of birth of the virtual account owner
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
      - `iban` string, required — The IBAN of the virtual account owner's bank account
      - `bicSwift` string, required — The BIC of the virtual account owner's bank account
    - CreateNoBankDetailsVirtualAccountForCompany
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `registrationNumber` string — The registration number of the virtual account owner - only applicable to a corporation. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation
    - CreateNoBankDetailsVirtualAccountForIndividual
      - `correlationId` string — The correlation ID provided on the account creation request. If you did not provide correlation ID, it will be generated
      - `name` string, required — The name of the virtual account owner. Must contain at least two words separated by a space. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `addressLine1` string, required — The first line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine2` string — The second line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `addressLine3` string — The third line of the address of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' ',' and spaces are allowed (no leading spaces).
      - `city` string, required — The postal city or town of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `region` string — The region (e.g. county, state, province, etc.) of the virtual account owner. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `postcode` string — The postal code (e.g. postcode, zip code, etc.) of the virtual account owner. Postcode is required for CHAPS payments. Only English alphabet letters, numbers, '/-?:().'+' and spaces are allowed (no leading spaces).
      - `country` string, required — The 2-letter country code of the virtual account owner's bank account
      - `nationality` string, required — The 2-letter country code for the virtual account owner's nationality
      - `dateOfBirth` string, required — The date of birth of the virtual account owner - only applicable to an individual
      - `isIndividual` boolean, required — Whether the virtual account owner is an individual as opposed to a corporation

## Response `202`

The virtual account creation request was received successfully

## Other responses

- `404` — The accountId is unknown

---

[API](https://skmtc.net/bcb/apis/payments-api.md) · [All operations](https://skmtc.net/bcb/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bcb/payments-api/revisions/7559660d5268/schema)