Skip to main content
GET
List virtual accounts

Authorizations

Authorization
string
header
required

The data.access_token value from Get access token.

x-api-key
string
header
required

API key issued by Kira.

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.

These are not the values you get back on each row — 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