Skip to main content
finta brings Finta’s REST API to your terminal. Every API endpoint is a command.

Install

Run it again to update.
The install script and Homebrew also set up tab completion. finta tells you when a newer version is out.

Sign in

Your browser opens. Sign in, choose a company, and click Allow. The CLI can do whatever your role in Finta allows, and needs API access: Manage.
  • --no-open prints the sign-in link instead of opening a browser.
  • --with-api-key signs in with an API key instead. In CI, set FINTA_API_KEY.
  • finta whoami shows the company you’re signed in to. finta logout signs out.
New to Finta? Sign up with finta signups create --email you@company.com, click Activate in the email, run finta login, then finta onboarding retrieve to finish setting up.

Commands

Each command is an API resource and an action: GET /transactions is finta transactions list. Run finta --help to see them all, and --help on any command for its flags.
  • --all fetches every page of a list.
  • -d, --data sends a JSON body, for nested fields.
  • --dry-run prints the request without sending it.
  • finta api <method> <path> calls any API path, such as finta api GET "/transactions?limit=5".
  • finta export saves a report as a PDF, CSV or XLSX file, and finta upload imports transactions from a CSV.
New API endpoints show up as commands without updating finta.

Output

In a terminal, lists print as tables. When output is piped, or with --json, you get the API’s JSON:

Confirmations

Deletes and other changes that can’t be undone ask before they run. In a script or agent, pass --yes to confirm.

Exit codes

If a change times out, finta doesn’t retry it. It tells you the command to check whether it went through.

Coding agents

Coding agents like Claude Code, Codex and Cursor can run finta directly: they get JSON output and --help for every command. They should pass --yes only after you approve a change. To connect an AI app like Claude or ChatGPT instead, use the MCP server.