Vezmo App

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_account or stablecoin_address.
  • status — pending, active, failed or closed.
  • limit, startingAfter — paging.
Request
curl "https://api.vezmo.com/api/v1/accounts?currency=USD&status=active" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Vezmo-Version: 2026-11-14"
200 OK
{
  "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 — from ach, 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, or null when another account shows the same balance; balanceAccountId names 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 of total.
  • reserved — transfers on their way out.
  • total — available + reserved.
200 OK
{
  "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 }
    ]
  }
}