Accounts API · Accounts API
Accounts and balances
Requires accounts.read. Every read is scoped to your business and your key's mode: a test key reads the sandbox, a live key your real accounts.
List accounts — GET /accounts
One entry per account: bank account details in a currency, or a stablecoin deposit address.
currency— a 3-letter code.kind—bank_accountorstablecoin_address.status—pending,active,failedorclosed.limit,startingAfter— paging.
curl "https://api.vezmo.com/api/v1/accounts?currency=USD&status=active" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Vezmo-Version: 2026-11-14"{
"success": true,
"data": [
{
"id": "acct_cm2v8q1k70003",
"kind": "bank_account",
"currency": "USD",
"status": "active",
"holderName": "Northwind Audio LLC",
"bankName": "Example Bank, N.A.",
"maskedNumber": "••••4821",
"rails": ["ach", "wire"],
"coin": null,
"network": null,
"depositAddress": null,
"balanceAccountId": "acct_cm2v8q1k70003",
"balance": { "available": 1248000, "pending": 125000, "reserved": 30000, "total": 1278000 },
"openedAt": "2026-10-02T14:11:09.000Z",
"createdAt": "2026-10-01T09:30:00.000Z"
}
],
"meta": { "hasMore": false, "nextCursor": null },
"requestId": "…",
"timestamp": "…"
}Fields
maskedNumber— the last 4 digits only. Full numbers aren't sent by API in this phase.bankName— the receiving bank, in our words.rails— fromach,wire,fednow,rtp,swift,sepa,local_transfer.holderName— your verified legal or personal name while your verification is approved, else your business name.coin,network,depositAddress— for a stablecoin address (the full address: payers need all of it).balance— this account's balance, ornullwhen another account shows the same balance;balanceAccountIdnames it. Accounts' balances add up to/balances.
Get one account — GET /accounts/{id}
The same object. Another business's id answers 404 not_found “No such account.”
Balances — GET /balances
One entry per currency, in minor units:
available— what you can use now.pending— arrived, not yet credited. Not part oftotal.reserved— transfers on their way out.total—available+reserved.
{
"success": true,
"data": {
"asOf": "2026-11-14T10:00:00.000Z",
"balances": [
{ "currency": "USD", "available": 1248000, "pending": 125000, "reserved": 30000, "total": 1278000 },
{ "currency": "EUR", "available": 54020, "pending": 0, "reserved": 0, "total": 54020 }
]
}
}