fobs stm reports
fobs stm reports show <name> [options]
Server-computed analytics. Output is always JSON (response shapes don't fit a table).
reports show <name>
fobs stm reports show expense
fobs stm reports show cashflow --from 2026-04-01 --to 2026-06-30
fobs stm reports show income --group-by month
fobs stm reports show balance --accounts acc1,acc2
fobs stm reports show expense --particulars "amazon"
fobs stm reports show income --entity bank
fobs stm reports show expense --category cc_emi_interest
Valid Report Names
| Name | Description |
|---|---|
overview | Top-level snapshot — totals, trends |
cashflow | Inflow / outflow over time |
income | Income breakdown |
expense | Expense breakdown |
asset | Asset accumulation |
liability | Liability balances |
transfer | Inter-account transfers |
balance | Account balances over time |
inflow_outflow | Per-period inflow vs outflow |
data-coverage | Date range covered per account |
Each report has its own response shape — see the matching page under Reports API.
Flags
| Flag | Description |
|---|---|
--from <YYYY-MM-DD> | Period start |
--to <YYYY-MM-DD> | Period end |
--group-by <period> | day, week, month, or year |
--accounts <ids> | Comma-separated account IDs |
--particulars <text> | Case-insensitive substring on transaction description |
--entity <text> | Filter by entity |
--category <text> | Filter by category |
Not every flag applies to every report — the server ignores filters it doesn't support for a given report name.
Piping to jq
fobs stm reports show expense --from 2026-04-01 --to 2026-04-30 \
| jq '.data | keys'
fobs stm reports show cashflow --group-by month \
| jq '.data[] | {period: .period, net: (.inflow - .outflow)}'
Related
- Reports API — REST endpoints and response shapes
- Reports guide — product-side overview
- Common Flags — flags that work across commands