List financial accounts
GET/financial-accounts
Returns a cursor-paginated page of financial accounts for the workspace tied to the token's sub claim. Accounts may belong to a specific company or be workspace-level (company_id nullable). The current balance is NOT returned by this listing — the stored balance column is a write-only seed; the real balance is derived from the transactions ledger and will be available on the detail endpoint. Requires scope finance.accounts.
Request
Responses
- 200
- 400
- 401
- 403
- 429
- 500
Page of accounts plus pagination metadata. No balance field by design.
Malformed query (unknown filter / operator, invalid limit, bad cursor).
Missing / invalid / expired / revoked token.
Token authenticated but lacks the finance.accounts scope, or sub does not match any workspace.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.