Returns account-level data for the organization that owns the API key: its tax code, its Billingo subscription, and whether NAV Online Számla is connected. This is NOT a company profile — it contains no name, id or address. Use it to check the subscription or NAV connection status.

Looks up a Hungarian tax number at NAV and returns the company data behind it. Use this to validate a tax number before creating a partner. Works only when the Billingo account has a live NAV Online Számla connection (not available on sandbox accounts).

Returns the conversion rate Billingo would apply between two currencies.

Lists partners (customers), newest first. Supports paging and a free-text search over the partner name.

Returns a single partner by id.

Lists products and services from the product catalogue.

Returns a single product by id.

Returns the current inventory quantity for a product.

Lists recorded spendings (costs), optionally filtered by date range.

Returns a single spending by id.

Lists the bank accounts configured on the organization.

Returns a single bank account by id.

Lists document blocks (invoice number ranges). Every document belongs to a block; you need a block id to create an invoice.

Lists documents (invoices, receipts, proformas, drafts and more), newest first. Filter by type, invoice date range, fulfillment date range, payment date range, last modification time, partner, payment status/method or document block.

Returns a single document. Give either id (the Billingo document id) or vendor_id (your own external reference set when the document was created).

Gets the document PDF. By default returns a shareable public URL — this is what works in most MCP clients (including Claude Desktop, which rejects the base64 file attachment) and is what you want in almost every case. Pass format="base64" only when a caller specifically needs the raw PDF bytes: it costs a lot of context (base64 is ~1.33x the PDF size) and some clients cannot render the result at all.

Returns a shareable public URL for the document, viewable without a Billingo login.

Returns the NAV Online Számla reporting status of a document: the transaction id, the status, and any validation messages from NAV. Use this to check whether reporting succeeded. Errors (4xx, "NavOnlineSzamla is not found") when the document has no NAV record at all — for example when the organization is not connected to NAV Online Számla, or the document is not subject to reporting. That is not a NAV failure; it means there is nothing to report on.

Returns the payments recorded against a document.

Returns the payment reminder events sent for a document, grouped into sent, upcoming and postal-mail reminders.

Returns a printable PDF receipt for a document, sized for a POS thermal printer.

Exports documents in a date range to a downloadable file, in one of the accounting/reporting formats Billingo supports (e.g. simple_csv, simple_excel, or a named accounting-system format). Creates the export, waits for it to finish, and returns the file. Nothing is modified. Textual formats (simple_csv, nav_xml, and other XML/JSON-based targets) come back as readable text you can analyse directly — very large exports are truncated with an explicit note, and a narrower date range will return the whole thing. Binary formats (simple_excel, simple_excel_items) come back as a file attachment that some MCP clients cannot display inline.