Skip to main content
GET
https://apis.hopnow.io
/
v1
/
accounts
/
{account_id}
/
virtual-accounts
/
{virtual_account_id}
Get Virtual Account
curl --request GET \
  --url https://apis.hopnow.io/v1/accounts/{account_id}/virtual-accounts/{virtual_account_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "account_id": "<string>",
  "currency": "<string>",
  "bank_details": {
    "ibans": [
      {}
    ],
    "iban": "<string>",
    "bic": "<string>",
    "bank_name": "<string>",
    "account_number": "<string>",
    "routing_number": "<string>"
  },
  "reference": "<string>",
  "provider_reference_id": "<string>",
  "label": "<string>",
  "status": "<string>",
  "created": "<string>",
  "updated": "<string>"
}

​
Path Parameters

​
account_id
string
required
The account’s external ID (starts with acc_)
​
virtual_account_id
string
required
The virtual account’s external ID (starts with va_)

​
Response

​
id
string
Virtual account identifier (starts with va_)
​
object
string
Always returns "virtual_account"
​
account_id
string
Parent account ID
​
currency
string
Virtual account currency
​
bank_details
object
Banking details for receiving payments
​
reference
string
Reference for payment reconciliation
​
provider_reference_id
string
Provider reference identifier
​
label
string
User-friendly label
​
status
string
Virtual account status: active, suspended, or inactive
​
created
string
ISO 8601 timestamp when created
​
updated
string
ISO 8601 timestamp when last updated

​
Response Example

{
  "id": "va_1234567890abcdef",
  "object": "virtual_account",
  "account_id": "acc_1234567890abcdef",
  "currency": "EUR",
  "bank_details": {
    "ibans": ["DE89370400440532013000", "DE89370400440532013001"],
    "iban": "DE89370400440532013000",
    "bic": "DEUTDEFFXXX",
    "bank_name": "Deutsche Bank"
  },
  "provider_reference_id": "BC-123456",
  "reference": "REF-001",
  "label": "EU Collections",
  "status": "active",
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}