Skip to main content
GET
/
api
/
v2
/
virtual-accounts
Get all virtual accounts
curl --request GET \
  --url https://sandbox.killb.app/api/v2/virtual-accounts \
  --header 'Authorization: Bearer <token>'
{
  "virtualAccounts": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "customerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "WALLET",
      "subtype": "PRE_FUND",
      "status": "ACTIVE",
      "address": "<string>",
      "currency": "USDC",
      "network": "POLYGON",
      "active": true,
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-01T00:00:00.000Z",
      "userId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "total": 100,
  "page": 1,
  "limit": 10,
  "totalPages": 10
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
page
number

Page number

Example:

1

​
limit
number

Items per page

Example:

10

​
status
enum<string>

Filter by account status

Available options:
ACTIVE,
PENDING,
REJECTED,
PROCESSING
​
network
enum<string>

Filter by network

Available options:
POLYGON,
ERC20,
SOLANA,
TRON,
ARBITRUM,
BSC
​
currency
enum<string>

Filter by currency

Available options:
USD,
USDC,
USDT
​
userId
string<uuid>

Filter by user ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
startDate
string<date-time>

Filter by start date

Example:

"2024-01-01T00:00:00.000Z"

​
endDate
string<date-time>

Filter by end date

Example:

"2024-12-31T23:59:59.999Z"

Response

​
virtualAccounts
object[]
required
​
total
number
required

Total number of virtual accounts

Example:

100

​
page
number
required

Current page number

Example:

1

​
limit
number
required

Items per page

Example:

10

​
totalPages
number
required

Total number of pages

Example:

10