Command Line & API

The bonbox CLI puts your receipts, invoices and customers in the terminal. It talks to the public bonbox REST API with your normal bonbox account — no extra credentials, no direct database access. Handy for scripting, bulk work and anything you would rather automate than click.

Install

The CLI is a Node package (Node 20 or newer) and installs globally as bonbox:

npm i -g bonbox

Sign in

bonbox login opens your browser and signs you in with Google, Apple, or email + password — the same account you use in the app. The session is stored on your machine and refreshed automatically, so you only do this once.

bonbox login
bonbox whoami

Everyday commands

Create an invoice with line items (<code>description:quantity:unit price[:discount]</code>) and save the PDF:

bonbox invoices create \
  --customer "Velo GmbH" \
  --item "Design work:8:145" \
  --item "Retainer:1:2000:10%" \
  --pdf invoice.pdf

Mark an invoice as paid — the income is booked as a receipt at the same time:

bonbox invoices paid 260830-001

Upload one or more receipts; amount, date and vendor are extracted automatically:

bonbox receipts scan lunch.jpg train-ticket.pdf

List last month's receipts as JSON, ready to pipe into your own scripts:

bonbox receipts ls --month 2026-08 --json

See your customers:

bonbox customers ls

Every command accepts --json for the raw response and --lang for the output language. bonbox --help lists everything.

API

The CLI is a thin layer over the public REST API at https://app.bonbox.io/api/v1.

https://app.bonbox.io/api/v1/openapi.json

Requires bonbox Pro

The CLI and the API are part of bonbox Pro.

Ready to simplify your bookkeeping?

Download bonbox and get started in minutes.

App Store Google Play Web App