> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borderless.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Virtual accounts

<Note>
  If you're just getting started, please check out our [quick start guide](/docs/quick-start-guide).
</Note>

There are two events regarding virtual accounts:

* VirtualAccount\_Created
* VirtualAccount\_CreationFailed

## Created

**VirtualAccount\_Created** is sent after virtual account has been created successfully and deposit instructions obtained. Below is a payload example:

<CodeGroup>
  ```bash bash theme={null}
  {
      "organizationId": "clxt0xrqp0000gokerkq2mpdl",
      "type": "VirtualAccount_Created",
      "data": {
          "id": "cmbz2ee050011yn24wqjru28f",
          "accountId": "cmbz2dgni000tyn241ip38gwj",
          "counterPartyIdentityId": "cmbz0v42m0002yn53zeayhilz",
          "status": "Active",
          "asset": "USDC_ETHEREUM",
          "fiat": "USD",
          "instructions": {
              "currency": "usd",
              "bank_name": "Bank of Nowhere",
              "bank_address": "1800 North Pole St., Orlando, FL 32801",
              "payment_rail": "ach_push",
              "payment_rails": [
                  "ach_push",
                  "wire"
              ],
              "bank_account_number": "900544275163",
              "bank_routing_number": "101019644",
              "bank_beneficiary_name": "Olaf Kling",
              "bank_beneficiary_address": "123 Washington St, Apt 2F, Chicago, IL 10001, US"
          },
          "createdAt": "2025-06-16T12:22:42.533Z",
          "failureReason": null
      },
      "timestamp": 1750076563854
  }
  ```
</CodeGroup>

## Failed

**VirtualAccount\_CreationFailed** is sent after virtual account failed to create.

<CodeGroup>
  ```bash bash theme={null}
  {
      "organizationId": "clxt0xrqp0000gokerkq2mpdl",
      "type": "VirtualAccount_CreationFailed",
      "data": {
          "id": "cmbz2brwb000nyn245kyyrgqw",
          "accountId": "cmbhs3xxa000nynt7lqwbyjsw",
          "counterPartyIdentityId": "cmbz0v42m0002yn53zeayhilz",
          "status": "Rejected",
          "asset": "USDC_POLYGON",
          "fiat": "USD",
          "instructions": null,
          "createdAt": "2025-06-16T12:20:40.572Z",
          "failureReason": "Couldn't find asset USDC_POLYGON in account: cmbhs3xxa000nynt7lqwbyjsw, add this asset to account before using it"
      },
      "timestamp": 1750076440780
  }
  ```
</CodeGroup>

<Info>
  If you have any questions, please don't hesitate to reach out to us via [email](mailto:support@borderless.xyz) or slack.
</Info>