List financial accounts
GET/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
- 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.
Unhandled server error.