API reference

Every endpoint exposed by the gnubok REST API, grouped by resource. Auto-generated from the same Zod registry that powers the OpenAPI 3.1 spec, the MCP tool surface, and runtime validators — there is no separate doc-source to keep in sync.

Resources

Companies

List and read companies the API key can access.

Customers

CRM-side: who you invoice. Business and individual (sole-trader) customers with VIES validation.

Invoices

Outbound invoicing — draft, send, mark paid, credit, PDF download. Mixed-rate VAT supported.

Suppliers

AP-side counterparties. Mirrors customers on the supplier vertical.

Supplier invoices

AP lifecycle: register, approve, mark paid, credit. With ROT/RUT and reverse-charge support.

Transactions

Bank transactions — ingest, categorise, match to invoices, reconcile.

Reconciliation

Run bank-to-ledger reconciliation and read the current matching status.

Journal entries

The bookkeeping engine surface — verifikation lifecycle (draft, commit, reverse, correct).

Voucher gap explanations

Documented explanations for gaps in the voucher series, per BFNAR 2013:2.

Fiscal periods

Period lifecycle — lock, close, year-end, opening balances, FX revaluation. Async via the operations substrate.

Accounts

Read the chart of accounts (BAS).

Documents

Multipart upload, signed-URL download (15-min TTL), link to journal entries.

Employees

Payroll roster — CRUD with personnummer masking on list endpoints.

Salary runs

Payroll lifecycle — create, calculate, approve, mark paid, book, generate AGI XML.

Reports

Read-only reports — trial balance, P&L, balance sheet, GL, VAT, salary journal, SIE export, +9 more.

Imports

Bulk async ingest — SIE files (Fortnox/Visma/BL/SpeedLedger/Bokio migrations) and bank statements (11 formats).

Compliance check

Pre-flight verification — voucher gaps, year-end readiness, before submitting to Skatteverket.

Webhooks

Subscribe to events with HMAC-signed delivery, exponential retries, and dead-letter replay.

Operations

Poll long-running async operations (year-end closing, imports, currency revaluation).