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.
curl "https://api.vezmo.com/api/v1/statements?currency=USD&period=2026-10" \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"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).
{
"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
}
]
}accountis masked: the last 4 digits and the public routing codes only. A stablecoin address showscoin,networkanddepositAddress.- 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).
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.pdfLimits
- 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.” withRetry-After: 5. - A finished month raises statement.available.