Vezmo App

Accounts API · Accounts API

Statements

Requires statements.read. One statement per account (one currency balance) per month, from the month money was first booked on it. A month is final 15 minutes after it ends; the current month changes until then.

List statements — GET /statements

Filters accountId, currency, period (YYYY-MM), plus paging. Newest first.

Request
curl "https://api.vezmo.com/api/v1/statements?currency=USD&period=2026-10" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
One entry of data[]
{
  "id": "stmt_cm2v8q1k70003_202610",
  "object": "statement",
  "accountId": "acct_cm2v8q1k70003",
  "currency": "USD",
  "period": "2026-10",
  "periodStart": "2026-10-01T00:00:00.000Z",
  "periodEnd": "2026-11-01T00:00:00.000Z",
  "final": true
}

Get one statement — GET /statements/{id}

format: json (default), csv or pdf. part: which part of a large month (from 1).

200 OK (format=json, data)
{
  "id": "stmt_cm2v8q1k70003_202610",
  "accountId": "acct_cm2v8q1k70003",
  "currency": "USD",
  "period": "2026-10",
  "final": true,
  "account": {
    "kind": "bank_account",
    "maskedNumber": "••••4821",
    "bankName": "Example Bank, N.A.",
    "routingCodes": { "aba": "021000021" },
    "holderName": "Northwind Audio LLC"
  },
  "openingBalance": 902000,
  "moneyIn": 624900,
  "moneyOut": 249000,
  "closingBalance": 1277900,
  "part": 1,
  "parts": 1,
  "partOpeningBalance": 902000,
  "partClosingBalance": 1277900,
  "pdfParts": 1,
  "lines": [
    {
      "transactionId": "txn_cm3k9q2xv0001",
      "postedAt": "2026-10-14T16:02:11.000Z",
      "description": "Money in from Harbor & Co.",
      "detail": null,
      "direction": "in",
      "amount": 124900,
      "balance": 1026900
    }
  ]
}
  • account is masked: the last 4 digits and the public routing codes only. A stablecoin address shows coin, network and depositAddress.
  • JSON and CSV parts hold 5,000 lines; PDF parts 500 (pdfParts). Each part has its own opening and closing balance.
  • CSV columns: date, description, detail, money_in, money_out, balance, currency, transaction_id, with rows “Opening balance” / “Closing balance” (“Balance brought forward” / “Balance carried forward” on a part). Amounts are decimals; cells are formula-safe.
  • The PDF is the dashboard's statement with the account number masked. Test keys get JSON and CSV only (sandbox).
CSV and PDF
curl "https://api.vezmo.com/api/v1/statements/stmt_cm2v8q1k70003_202610?format=csv" \
  -H "Authorization: Bearer $ACCESS_TOKEN" -o october.csv

curl "https://api.vezmo.com/api/v1/statements/stmt_cm2v8q1k70003_202610?format=pdf&part=1" \
  -H "Authorization: Bearer $ACCESS_TOKEN" -o october.pdf

Limits

  • 30 a minute per key; 60 new statements a minute per business (a month already made is free).
  • Busy: 503 service_unavailable “Statements are busy on our side right now. Try again in a few seconds.” with Retry-After: 5.
  • A finished month raises statement.available.