# Sign the request first — see Authentication for x-timestamp, x-nonce and x-signature
curl "https://api.sbx.hopnow.io/va/v1/accounts/acct_3mnq7c1e6a2b4f3c9b8d2e5a/virtual-accounts/va_7yq2m9p4q1w8e5r3t6y0u2i4" \
-H "x-api-key: $API_KEY" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-nonce: $NONCE" \
-H "x-signature: $SIGNATURE"
{
"id": "va_7yq2m9p4q1w8e5r3t6y0u2i4",
"object": "virtual_account",
"account_id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
"currency": "EUR",
"status": "active",
"beneficiary_name": "Acme GmbH",
"beneficiary_address": null,
"bank_name": "Partner Bank",
"bank_address": null,
"account_name": null,
"account_number": "DE89370400440532013000",
"iban": "DE89370400440532013000",
"swift_bic": "PBNKDEFF",
"routing_number": null,
"sort_code": null,
"intermediary_bank_name": null,
"intermediary_swift_bic": null,
"supported_rails": ["sepa", "swift"],
"balance": "12500.00",
"pending_deposit": "300.00",
"held_for_payment": "1200.00",
"total_balance": "14000.00",
"created": "2026-05-01T10:05:00Z",
"updated": null
}
Virtual Accounts
Get Virtual Account
Fetch a single virtual account with its readiness status, bank details, and balances
GET
/
va
/
v1
/
accounts
/
{account_id}
/
virtual-accounts
/
{virtual_account_id}
# Sign the request first — see Authentication for x-timestamp, x-nonce and x-signature
curl "https://api.sbx.hopnow.io/va/v1/accounts/acct_3mnq7c1e6a2b4f3c9b8d2e5a/virtual-accounts/va_7yq2m9p4q1w8e5r3t6y0u2i4" \
-H "x-api-key: $API_KEY" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-nonce: $NONCE" \
-H "x-signature: $SIGNATURE"
{
"id": "va_7yq2m9p4q1w8e5r3t6y0u2i4",
"object": "virtual_account",
"account_id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
"currency": "EUR",
"status": "active",
"beneficiary_name": "Acme GmbH",
"beneficiary_address": null,
"bank_name": "Partner Bank",
"bank_address": null,
"account_name": null,
"account_number": "DE89370400440532013000",
"iban": "DE89370400440532013000",
"swift_bic": "PBNKDEFF",
"routing_number": null,
"sort_code": null,
"intermediary_bank_name": null,
"intermediary_swift_bic": null,
"supported_rails": ["sepa", "swift"],
"balance": "12500.00",
"pending_deposit": "300.00",
"held_for_payment": "1200.00",
"total_balance": "14000.00",
"created": "2026-05-01T10:05:00Z",
"updated": null
}
Fetches a single virtual account with its current readiness status, bank-details payload, and balances. No request body. Use this endpoint as the source of truth for the current balances; the bank details are already returned by Create Virtual Account.
Virtual accounts only exist for supported currencies — Create Virtual Account fails with
422 UNSUPPORTED_CURRENCY for unsupported ones, so this endpoint never returns a degraded shape. See Errors.Path Parameters
string
required
Account id (
acct_…) that owns the virtual account.string
required
Virtual account id (
va_…).Response
string
Virtual account id (
va_…).string
Always
virtual_account.string
Owning account id (
acct_…).string
Currency of the virtual account (ISO 4217).
string
active or revoked (disabled). pending and suspended are reserved and not currently returned.string | null
Account holder name on the virtual account.
string | null
Account holder address.
string | null
Name of the bank holding the virtual account.
string | null
Address of the holding bank.
string | null
Display name of the account.
string | null
Virtual bank account number (VBAN). Null when not supported by the rail.
string | null
IBAN, where the currency/rail supports it. Null when not supported by the rail.
string | null
SWIFT/BIC of the holding bank.
string | null
US ABA routing number (ACH / Fedwire).
string | null
UK sort code (Faster Payments).
string | null
Intermediary (correspondent) bank name, if applicable.
string | null
Intermediary bank SWIFT/BIC, if applicable.
string[]
Payment rails the virtual account can receive on:
ach, fedwire, swift, sepa, spei, pix, faster_payments.decimal
Available balance, currency-formatted.
decimal
Inbound deposits received but not yet credited to the available balance.
decimal
All funds held against this virtual account and not yet available: in-flight payments and transfers, FX holds, and platform or service fees. Equals
total_balance minus balance minus pending_deposit.decimal
Total balance including pending deposits and held funds.
timestamp
Creation timestamp (ISO 8601, UTC).
timestamp | null
Last update timestamp (ISO 8601, UTC).
# Sign the request first — see Authentication for x-timestamp, x-nonce and x-signature
curl "https://api.sbx.hopnow.io/va/v1/accounts/acct_3mnq7c1e6a2b4f3c9b8d2e5a/virtual-accounts/va_7yq2m9p4q1w8e5r3t6y0u2i4" \
-H "x-api-key: $API_KEY" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-nonce: $NONCE" \
-H "x-signature: $SIGNATURE"
{
"id": "va_7yq2m9p4q1w8e5r3t6y0u2i4",
"object": "virtual_account",
"account_id": "acct_3mnq7c1e6a2b4f3c9b8d2e5a",
"currency": "EUR",
"status": "active",
"beneficiary_name": "Acme GmbH",
"beneficiary_address": null,
"bank_name": "Partner Bank",
"bank_address": null,
"account_name": null,
"account_number": "DE89370400440532013000",
"iban": "DE89370400440532013000",
"swift_bic": "PBNKDEFF",
"routing_number": null,
"sort_code": null,
"intermediary_bank_name": null,
"intermediary_swift_bic": null,
"supported_rails": ["sepa", "swift"],
"balance": "12500.00",
"pending_deposit": "300.00",
"held_for_payment": "1200.00",
"total_balance": "14000.00",
"created": "2026-05-01T10:05:00Z",
"updated": null
}