Get a virtual account

curl "$RHEON_API/v1/virtual-accounts/va_8f2c91d0a4" \
  -H "Authorization: Bearer $RHEON_API_KEY"

{
  "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"
}

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 until this lands.

Returns one virtual account by id, in the same shape 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.

Request

string

required

The virtual account id returned at creation.

Response

The full account object: id, wallet, chain, asset, rail, currency, reference, details, feeBps, active, createdAt. Field meanings are on Create a virtual account.

For whether money has arrived on the account, poll POST /v1/fiat/status - this endpoint describes the account, not its funding.

curl "$RHEON_API/v1/virtual-accounts/va_8f2c91d0a4" \
  -H "Authorization: Bearer $RHEON_API_KEY"

{
  "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"
}

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.

Getting started

Crypto deposits

Card payments

Bank transfers

Virtual accounts

Reference

Get a virtual account

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors