CLI Reference
The fobs CLI is the terminal companion to the Statements API. Anything you can pull from the API, you can pull from fobs stm <resource> — usually faster, with table output by default and --json / --format csv for piping.
fobs is multi-app: the same binary also talks to FinOpsBricks Billing and Orchestrator. This reference covers only the Statements commands (fobs stm ...). For installation and the full multi-app surface, see the fobs repository.
Command Pattern
fobs statements <resource> <action> [target] [options]
fobs stm <resource> <action> [target] [options] # short form
Both forms are equivalent. Examples below use stm.
Resources
| Resource | Commands | Description |
|---|---|---|
| accounts | list, show, balance | Bank accounts and credit cards |
| transactions | list, show | Imported transactions |
| statements | list, show, download, extracted, rename, update, archive, unarchive, retry, delete-transactions, delete | Uploaded statement files |
| rules | list, show | Categorization rules |
| reports | show | Server-computed reports |
| categories | list | Category aggregates (read-only) |
| entities | list | Entity aggregates (read-only) |
Quick Example
# Switch to an org you've configured
fobs orgs use my-org
# List accounts as a table
fobs stm accounts list
# Pull all April transactions as CSV
fobs stm transactions list --from 2026-04-01 --to 2026-04-30 \
--format csv --output april.csv
# Compute and print the cashflow report as JSON
fobs stm reports show cashflow --from 2026-04-01 --to 2026-04-30
Before You Start
You need an org configured with Statements credentials. See Setup for fobs orgs add and credential file details.
Related
- Setup — Auth and config
- Common Flags —
--json, paging, exit codes - API Authentication — how
api-key/api-secretwork - fobs repo — install, billing, orchestrator commands