Skip to main content
GET
List virtual accounts

Authorizations

Authorization
string
header
required

The data.access_token value from Get access token.

Headers

X-Api-Version
string

Version applied to this request. It wins over your account's pinned version — see Versioning.

Example:

"2026-04-14"

Query Parameters

limit
integer
default:10

How many accounts to return. Between 1 and 100, and 10 when you omit it.

A value outside that range is rejected with a 400.

Required range: 1 <= x <= 100
offset
integer
default:0

How many accounts to skip before the first row returned. Use it with limit to walk the list: offset=0, then offset=10, and so on. 0 when you omit it.

Required range: x >= 0
status
string

Filter by account status.

Available options: pending, activating, active, failed, deactivated, frozen.

deactivated and frozen come back on each row as they are. pending, activating, active and failed come back under other names. See status in the response.

See Virtual account values for what each one means.

user_id
string<uuid>

Return only the accounts owned by this user.

type
string

Filter by account type.

Available options: US_BANK.

mode
string

Filter by what happens to a deposit.

Available options: fiat, crypto.

See Virtual account values for what each one means.

Free-text search over the account. Between 1 and 255 characters.

Required string length: 1 - 255
metadata
object

Return only the accounts carrying the metadata you name, in the ?metadata[key]=value form. Pass more than one key to require all of them.

Each key is 1 to 40 characters and cannot contain [ or ].

Response

Success.

data
object[]
pagination
object