Skip to main content
GET
List virtual accounts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer | null
default:100

Number of items per page

Required range: 1 <= x <= 1000
Example:

10

offset
integer | null
default:0

Number of items to skip

Required range: x >= 0
Example:

0

nameSearchQuery
string | null

Return virtual accounts with names that contain this string.

Example:

"staging-bot"

ownedByTeams
string[] | null

Comma-separated team names. Return virtual accounts owned by these teams.

Example:

"ml-team,infra-team"

isExpired
boolean | null

Filter by expiration status. true = expired only, false = not expired only.

filter
string | null

JSON string: structured filter tree (AND/OR groups, column leaves on name, json_map leaves on manifest.tags).

Example:

"{\"type\":\"AND\",\"children\":[{\"column\":\"name\",\"op\":\"STRING_CONTAINS\",\"value\":\"bot\"}]}"

Response

200 - application/json

Paginated list of virtual accounts the caller has access to.

data
VirtualAccount · object[]
required

Array of virtual accounts matching the query.

pagination
Pagination · object
required

Pagination metadata.