> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.lucanto.eu/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.lucanto.eu/_mcp/server. # API Reference ## API Docs - [List bank accounts and cash registers](https://docs.lucanto.eu/api-reference/api-reference/bank-accounts/list-bank-accounts.md): API Reference > Bank Accounts - [Create a bank account or cash register](https://docs.lucanto.eu/api-reference/api-reference/bank-accounts/create-bank-account.md): API Reference > Bank Accounts - [Get a bank account or cash register](https://docs.lucanto.eu/api-reference/api-reference/bank-accounts/get-bank-account.md): API Reference > Bank Accounts - [Soft-delete a bank account](https://docs.lucanto.eu/api-reference/api-reference/bank-accounts/delete-bank-account.md): API Reference > Bank Accounts - [Update a bank account or cash register](https://docs.lucanto.eu/api-reference/api-reference/bank-accounts/update-bank-account.md): API Reference > Bank Accounts - [Fold a duplicate account into the one that survives](https://docs.lucanto.eu/api-reference/api-reference/bank-accounts/merge-bank-account.md): API Reference > Bank Accounts - [List the per-account new-transaction switches](https://docs.lucanto.eu/api-reference/api-reference/bank-account-notification-preferences/list-bank-account-notification-preferences.md): API Reference > Bank Account Notification Preferences - [Switch new-transaction pushes for one bank account](https://docs.lucanto.eu/api-reference/api-reference/bank-account-notification-preferences/update-bank-account-notification-preference.md): API Reference > Bank Account Notification Preferences - [List bank statements](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/list-bank-statements.md): API Reference > Bank Statements - [Upload a bank statement](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/create-bank-statement.md): API Reference > Bank Statements - [Get a bank statement](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/get-bank-statement.md): API Reference > Bank Statements - [Delete an archived bank statement](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/delete-bank-statement.md): API Reference > Bank Statements - [Set or update a bank statement's period](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/update-bank-statement.md): API Reference > Bank Statements - [List a statement's extracted rows](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/list-bank-statement-entries.md): API Reference > Bank Statements - [Add a row to a statement's staging area](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/create-bank-statement-entry.md): API Reference > Bank Statements - [Book a statement's reviewed rows as transactions](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/import-bank-statement-entries.md): API Reference > Bank Statements - [Re-run the AI extraction on a PDF statement](https://docs.lucanto.eu/api-reference/api-reference/bank-statements/retry-bank-statement-extraction.md): API Reference > Bank Statements - [The stored register check of the workspace's company](https://docs.lucanto.eu/api-reference/api-reference/company-profile/company-register-check.md): API Reference > Company Profile - [Dismiss the register discrepancy as a register error](https://docs.lucanto.eu/api-reference/api-reference/company-profile/dismiss-company-register-check.md): API Reference > Company Profile - [List contacts](https://docs.lucanto.eu/api-reference/api-reference/contacts/list-contacts.md): API Reference > Contacts - [Create a contact](https://docs.lucanto.eu/api-reference/api-reference/contacts/create-contact.md): API Reference > Contacts - [Get a contact](https://docs.lucanto.eu/api-reference/api-reference/contacts/get-contact.md): API Reference > Contacts - [Soft-delete a contact](https://docs.lucanto.eu/api-reference/api-reference/contacts/delete-contact.md): API Reference > Contacts - [Update a contact](https://docs.lucanto.eu/api-reference/api-reference/contacts/update-contact.md): API Reference > Contacts - [Suggested bank transactions for this credit note](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/list-credit-note-transaction-suggestions.md): API Reference > Credit Notes - [List credit notes](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/list-credit-notes.md): API Reference > Credit Notes - [Create a credit note](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/create-credit-note.md): API Reference > Credit Notes - [Get a credit note](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/get-credit-note.md): API Reference > Credit Notes - [Soft-delete a credit note](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/delete-credit-note.md): API Reference > Credit Notes - [Update a credit note](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/update-credit-note.md): API Reference > Credit Notes - [Issue a credit note (transition draft → issued)](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/issue-credit-note.md): API Reference > Credit Notes - [Mark a credit note as sent (transition issued → sent)](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/mark-credit-note-sent.md): API Reference > Credit Notes - [Send a credit note by email](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/send-credit-note.md): API Reference > Credit Notes - [Lock a credit note's content](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/lock-credit-note.md): API Reference > Credit Notes - [Reopen a locked credit note for editing](https://docs.lucanto.eu/api-reference/api-reference/credit-notes/reopen-credit-note.md): API Reference > Credit Notes - [Balances, receivables and the action inbox](https://docs.lucanto.eu/api-reference/api-reference/dashboard/summary.md): API Reference > Dashboard - [30-day cash-flow projection](https://docs.lucanto.eu/api-reference/api-reference/dashboard/cashflow.md): API Reference > Dashboard - [Register or refresh an APNs device token](https://docs.lucanto.eu/api-reference/api-reference/devices/register-device.md): API Reference > Devices - [Unregister a device token](https://docs.lucanto.eu/api-reference/api-reference/devices/unregister-device.md): API Reference > Devices - [Get the workspace's document settings](https://docs.lucanto.eu/api-reference/api-reference/document-settings/get-document-settings.md): API Reference > Document Settings - [Update the workspace's document settings](https://docs.lucanto.eu/api-reference/api-reference/document-settings/update-document-settings.md): API Reference > Document Settings - [Suggested bank transactions for this invoice](https://docs.lucanto.eu/api-reference/api-reference/invoices/list-invoice-transaction-suggestions.md): API Reference > Invoices - [List invoices](https://docs.lucanto.eu/api-reference/api-reference/invoices/list-invoices.md): API Reference > Invoices - [Create an invoice](https://docs.lucanto.eu/api-reference/api-reference/invoices/create-invoice.md): API Reference > Invoices - [Get an invoice](https://docs.lucanto.eu/api-reference/api-reference/invoices/get-invoice.md): API Reference > Invoices - [Soft-delete an invoice](https://docs.lucanto.eu/api-reference/api-reference/invoices/delete-invoice.md): API Reference > Invoices - [Update an invoice](https://docs.lucanto.eu/api-reference/api-reference/invoices/update-invoice.md): API Reference > Invoices - [Issue an invoice (transition draft → issued)](https://docs.lucanto.eu/api-reference/api-reference/invoices/issue-invoice.md): API Reference > Invoices - [Mark an invoice as sent (transition issued → sent)](https://docs.lucanto.eu/api-reference/api-reference/invoices/mark-invoice-sent.md): API Reference > Invoices - [Cancel an invoice (storno; transition issued/sent → canceled)](https://docs.lucanto.eu/api-reference/api-reference/invoices/cancel-invoice.md): API Reference > Invoices - [Send a payment reminder to the client](https://docs.lucanto.eu/api-reference/api-reference/invoices/send-invoice-reminder.md): API Reference > Invoices - [Send invoice by email](https://docs.lucanto.eu/api-reference/api-reference/invoices/send-invoice.md): API Reference > Invoices - [Mark an invoice as paid](https://docs.lucanto.eu/api-reference/api-reference/invoices/mark-invoice-paid.md): API Reference > Invoices - [Lock an invoice's content](https://docs.lucanto.eu/api-reference/api-reference/invoices/lock-invoice.md): API Reference > Invoices - [Reopen a locked invoice for editing](https://docs.lucanto.eu/api-reference/api-reference/invoices/reopen-invoice.md): API Reference > Invoices - [Download invoice PDF](https://docs.lucanto.eu/api-reference/api-reference/invoices/download-invoice-pdf.md): API Reference > Invoices - [Suggested bank transactions for this proforma](https://docs.lucanto.eu/api-reference/api-reference/proformas/list-proforma-transaction-suggestions.md): API Reference > Proformas - [List proformas](https://docs.lucanto.eu/api-reference/api-reference/proformas/list-proformas.md): API Reference > Proformas - [Create a proforma](https://docs.lucanto.eu/api-reference/api-reference/proformas/create-proforma.md): API Reference > Proformas - [Get a proforma](https://docs.lucanto.eu/api-reference/api-reference/proformas/get-proforma.md): API Reference > Proformas - [Soft-delete a proforma](https://docs.lucanto.eu/api-reference/api-reference/proformas/delete-proforma.md): API Reference > Proformas - [Update a proforma](https://docs.lucanto.eu/api-reference/api-reference/proformas/update-proforma.md): API Reference > Proformas - [Convert a proforma to a final invoice](https://docs.lucanto.eu/api-reference/api-reference/proformas/convert-proforma-to-invoice.md): API Reference > Proformas - [Issue a proforma (transition draft → issued)](https://docs.lucanto.eu/api-reference/api-reference/proformas/issue-proforma.md): API Reference > Proformas - [Mark a proforma as sent (transition issued → sent)](https://docs.lucanto.eu/api-reference/api-reference/proformas/mark-proforma-sent.md): API Reference > Proformas - [Cancel a proforma (transition issued/sent → canceled)](https://docs.lucanto.eu/api-reference/api-reference/proformas/cancel-proforma.md): API Reference > Proformas - [Mark a proforma as paid](https://docs.lucanto.eu/api-reference/api-reference/proformas/mark-proforma-paid.md): API Reference > Proformas - [Send a proforma by email](https://docs.lucanto.eu/api-reference/api-reference/proformas/send-proforma.md): API Reference > Proformas - [Send a payment reminder to the client](https://docs.lucanto.eu/api-reference/api-reference/proformas/send-proforma-reminder.md): API Reference > Proformas - [Lock a proforma's content](https://docs.lucanto.eu/api-reference/api-reference/proformas/lock-proforma.md): API Reference > Proformas - [Reopen a locked proforma for editing](https://docs.lucanto.eu/api-reference/api-reference/proformas/reopen-proforma.md): API Reference > Proformas - [List quotes](https://docs.lucanto.eu/api-reference/api-reference/quotes/list-quotes.md): API Reference > Quotes - [Create a quote](https://docs.lucanto.eu/api-reference/api-reference/quotes/create-quote.md): API Reference > Quotes - [Get a quote](https://docs.lucanto.eu/api-reference/api-reference/quotes/get-quote.md): API Reference > Quotes - [Soft-delete a quote](https://docs.lucanto.eu/api-reference/api-reference/quotes/delete-quote.md): API Reference > Quotes - [Update a quote](https://docs.lucanto.eu/api-reference/api-reference/quotes/update-quote.md): API Reference > Quotes - [Mark a quote as accepted by the customer](https://docs.lucanto.eu/api-reference/api-reference/quotes/accept-quote.md): API Reference > Quotes - [Mark a quote as sent (transition draft → sent)](https://docs.lucanto.eu/api-reference/api-reference/quotes/mark-quote-sent.md): API Reference > Quotes - [Mark a quote as rejected by the customer](https://docs.lucanto.eu/api-reference/api-reference/quotes/reject-quote.md): API Reference > Quotes - [Send a quote by email](https://docs.lucanto.eu/api-reference/api-reference/quotes/send-quote.md): API Reference > Quotes - [Lock a quote's content](https://docs.lucanto.eu/api-reference/api-reference/quotes/lock-quote.md): API Reference > Quotes - [Reopen a locked quote for editing](https://docs.lucanto.eu/api-reference/api-reference/quotes/reopen-quote.md): API Reference > Quotes - [Look up a company in the business register](https://docs.lucanto.eu/api-reference/api-reference/registry/lookup.md): API Reference > Registry - [List sales orders](https://docs.lucanto.eu/api-reference/api-reference/sales-orders/list-sales-orders.md): API Reference > Sales Orders - [Get a sales order](https://docs.lucanto.eu/api-reference/api-reference/sales-orders/get-sales-order.md): API Reference > Sales Orders - [List supplier cards](https://docs.lucanto.eu/api-reference/api-reference/suppliers/list-suppliers.md): API Reference > Suppliers - [Fold this supplier card into another](https://docs.lucanto.eu/api-reference/api-reference/suppliers/merge-supplier.md): API Reference > Suppliers - [Tax/levy/VAT forecast for the workspace](https://docs.lucanto.eu/api-reference/api-reference/tax/forecast.md): API Reference > Tax - [VAT-registration turnover watch for the workspace](https://docs.lucanto.eu/api-reference/api-reference/tax/vat-threshold.md): API Reference > Tax - [List transactions](https://docs.lucanto.eu/api-reference/api-reference/transactions/list-transactions.md): API Reference > Transactions - [Settle a document or expense with this transaction](https://docs.lucanto.eu/api-reference/api-reference/transactions/pair-transaction.md): API Reference > Transactions - [Link a refund to the charge it reverses](https://docs.lucanto.eu/api-reference/api-reference/transactions/pair-transaction-with-transaction.md): API Reference > Transactions - [Undo a settlement](https://docs.lucanto.eu/api-reference/api-reference/transactions/unpair-transaction.md): API Reference > Transactions - [Suggested matches for a transaction](https://docs.lucanto.eu/api-reference/api-reference/transactions/list-transaction-suggestions.md): API Reference > Transactions - [Get a transaction](https://docs.lucanto.eu/api-reference/api-reference/transactions/get-transaction.md): API Reference > Transactions - [Delete a transaction](https://docs.lucanto.eu/api-reference/api-reference/transactions/delete-transaction.md): API Reference > Transactions - [Get the current user](https://docs.lucanto.eu/api-reference/api-reference/user/get-current-user.md): API Reference > User - [Update the current user](https://docs.lucanto.eu/api-reference/api-reference/user/update-current-user.md): API Reference > User - [List the current user's workspaces](https://docs.lucanto.eu/api-reference/api-reference/workspaces/list-workspaces.md): API Reference > Workspaces - [Get a single workspace](https://docs.lucanto.eu/api-reference/api-reference/workspaces/get-workspace.md): API Reference > Workspaces - [Mark a workspace as the user's default](https://docs.lucanto.eu/api-reference/api-reference/workspaces/set-default-workspace.md): API Reference > Workspaces ## OpenAPI Specification - [OpenAPI JSON](https://docs.lucanto.eu/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://docs.lucanto.eu/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.lucanto.eu/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.lucanto.eu/_mcp/server. # API reference The reference in this section is refreshed from Lucanto's live OpenAPI specification whenever the docs are published. The source is [`app.lucanto.eu/api/v1/openapi.json`](https://app.lucanto.eu/api/v1/openapi.json), which is assembled by the deployed API. ## Conventions * **Base URL:** `https://app.lucanto.eu/api/v1` * **Auth:** `Authorization: Bearer ` — see [Authentication](/authentication) * **Workspace scoping:** business data lives under `/workspaces/{workspace_id}/...`; user, registry, and device operations are auth-scoped * **Lists:** large collections use `{ data, next_cursor, has_more }` cursor pagination — see [Pagination](/pagination) * **Errors:** standard errors use a uniform envelope; feature limits carry an actionable `code` — see [Errors](/errors) * **Retries:** `POST` supports the `Idempotency-Key` header — see [Idempotency](/idempotency) ## Resources Invoices, Quotes, Proformas, Credit Notes, Contacts, Bank Accounts, Bank Statements, Transactions, Document Settings, Tax, Registry, Devices, Users, and Workspaces. Per-account notification preferences control new-transaction pushes. Use the API Explorer on each endpoint to make live calls with your own token.