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

# Get a virtual account

> GET /v1/virtual-accounts/{id} - read one account, including its bank details.

<Warning>
  **Not available yet.** This endpoint answers `501 not_implemented`. The banking
  partner integration can open an account and report when it is funded, but cannot
  read one back or amend it, and we will not invent data or pretend the account never
  existed. Keep the details returned by
  [creation](/api-reference/virtual-account-create) until this lands.
</Warning>

Returns one virtual account by id, in the same shape
[create](/api-reference/virtual-account-create) returns. Use it to re-display the
bank details, and to poll for `details` on an asynchronously provisioned account
(USD, AED, COP) until they populate.

Needs the virtual-accounts permission on your key - see
[Authentication](/api-reference/authentication).

## Request

<ParamField path="id" type="string" required>
  The virtual account id returned at creation.
</ParamField>

## Response

The full account object: `id`, `wallet`, `chain`, `asset`, `rail`, `currency`,
`reference`, `details`, `feeBps`, `active`, `createdAt`. Field meanings are on
[Create a virtual account](/api-reference/virtual-account-create).

<Note>
  For whether money has arrived on the account, poll
  [`POST /v1/fiat/status`](/api-reference/bank-transfer) - this endpoint describes
  the account, not its funding.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl "$RHEON_API/v1/virtual-accounts/va_8f2c91d0a4" \
    -H "Authorization: Bearer $RHEON_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "va_8f2c91d0a4",
    "wallet": "0x2222222222222222222222222222222222222222",
    "chain": "arbitrum",
    "asset": "USDC",
    "rail": "sepa",
    "currency": "EUR",
    "reference": "user-84921",
    "details": {
      "iban": "IE25XXXX99035504017602",
      "bankName": "Example Bank",
      "swiftCode": "EXAMPIE2XXX",
      "accountName": "Rheon Payments"
    },
    "feeBps": 25,
    "active": true,
    "createdAt": "2026-08-31T10:00:00Z"
  }
  ```
</ResponseExample>

## Errors

| HTTP | `code`              | When                                                     |
| ---- | ------------------- | -------------------------------------------------------- |
| 401  | `unauthorized`      | Missing, malformed, or unknown API key.                  |
| 403  | `permission_denied` | Your key does not carry the virtual-accounts permission. |
| 404  | `not_found`         | No account with that id on your key.                     |
| 429  | `rate_limited`      | Over your key's rate limit.                              |
| 500  | `internal`          | Unexpected server error.                                 |