HisabiHisabi
All posts
Product6 min read·

The Hisabi Developer API v1 — Invoices and Clients, Programmatically

A REST API for the things you already do in the dashboard: create clients, issue invoices, send them, mark them paid, pull the PDFs. Bearer-key auth, an OpenAPI 3.1 spec, and it's included on every plan.

By Hisabi Team · Product
The Hisabi Developer API v1 — Invoices and Clients, Programmatically

If your business issues invoices from its own system — a booking platform, a store backend, an internal tool — you shouldn't have to retype them into a dashboard. The Developer API v1 exposes Hisabi's core objects over plain REST so your code can do it instead.

What You Can Do

The v1 API covers four resource areas:

  • Clients — list, create, fetch, update, and delete the people and companies you bill.
  • Invoices — create and list invoices, fetch one, update a draft, send it by email, mark it paid, and download the finished PDF.
  • Batch — create up to 100 invoices in one call, with per-row error reporting.
  • Brand assets — fetch pre-signed URLs for your logo and signature to reuse in your own flows.

Designed to Be Boring

Auth is a Bearer API key you create in your workspace settings. Responses follow the same shape as the rest of Hisabi: { data } on success, { error } on failure. The full machine-readable contract lives at /api/v1/openapi.json — an OpenAPI 3.1 document you can drop into Postman, Scalar, or your codegen tool of choice.

Everything is scoped to your workspace. A key can only ever see and touch the data of the workspace that issued it.

Included on Every Plan

The API is part of the product, not an enterprise add-on — it's available on every plan, including Free. Your plan's existing invoice and AI quotas apply to API-created objects the same way they apply in the dashboard.

Start at the developer page for the quickstart, endpoint reference, and example requests.

Product

Frequently Asked Questions

Can't find what you're looking for? Contact us

Create an API key in your workspace settings and send it as a Bearer token in the Authorization header. Keys are workspace-scoped and can be revoked at any time.

No. It's included on every plan, including Free. API usage draws from the same plan quotas as the dashboard — an invoice created via the API counts like one created by hand.

Yes — a public OpenAPI 3.1 document at /api/v1/openapi.json, fetchable without auth so docs tools and code generators can read it directly.

Per key, per plan: Free allows 20 requests a minute (500 a day), Starter 60 a minute, Professional 120, and Firm 300, with daily caps to match. If you're planning sustained high volume, write to us first and we'll talk it through.

Yes. Create a test-mode key in your workspace settings — invoices it creates are flagged as test data and don't count toward your monthly invoice limit. A live key can also pass test_mode: true on individual requests during development.

Get Started

Ready to try Hisabi?

Create VAT-compliant, bilingual invoices with AI. Free to start.