Expensicat
CLI

Transactions

Browse, categorize, and update bank transactions

Transactions are created automatically by bank syncs. The CLI lets you search, categorize, annotate, and remove them.

transaction list

List transactions with filters.

expensicat transaction list
expensicat transaction list --search "stripe" --status uncategorized --limit 50
FlagDescription
--search <string>Full-text search across name/description
--status <string>Filter by status (e.g. uncategorized, categorized, excluded)
--cursor <string>Pagination cursor
--limit <number>Page size

transaction show

Get a transaction by ID.

expensicat transaction show txn_abc123
ArgDescription
<id>Transaction ID

transaction update

Update category or notes on a transaction.

expensicat transaction update txn_abc123 --category-id cat_software --notes "Annual renewal"
ArgDescription
<id>Transaction ID
FlagDescription
--category-id <string>Category to assign
--notes <string>Free-form notes

transaction delete

Delete a transaction. Prompts for confirmation in a terminal; pass --yes to skip.

expensicat transaction delete txn_abc123
expensicat transaction rm txn_abc123 --yes   # alias + skip prompt
ArgDescription
<id>Transaction ID
FlagDescription
-y, --yesSkip the confirmation prompt (required for non-interactive use)

On this page