Skip to main content
GET
List Virtual Accounts
Returns the virtual accounts belonging to one virtual account group, newest first. There are no sort parameters. List items are the same shape as Get Virtual Account: every field, including the full bank details, is present on each row. There are no status or currency filters, so a group with several currencies returns them all and you filter client-side. Virtual accounts in another group on the same account are not included: list each group separately. Requires an API key with read access on the virtual_accounts scope. There is no disable or delete endpoint for virtual accounts on this API. A virtual account cannot be closed, frozen or renamed through the client API. frozen and disabled are set by Hop, so a virtual account you created stays in this list for the life of the account. Set a durable label when you create the virtual account: neither the label nor the account can be changed afterwards.

Path Parameters

string
required
The account’s external ID (starts with acct_)
string
required
The virtual account group’s external ID (starts with vag_). An unknown group, or one belonging to another account, returns 404, not an empty page.

Query Parameters

integer
default:"1"
Page number (minimum 1)
integer
default:"10"
Items per page (1-100)

Response

array
Virtual account objects, newest first
integer
Current page number
integer
Items per page
integer
Total number of items
integer
Total number of pages

Errors

Request Example

Response Example