# Lucanto | Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.lucanto.eu/_mcp/server

## Docs

- [Lucanto API](https://docs.lucanto.eu/welcome.md): Programmatic access to invoices, contacts, banking, and workspace data
- [Quickstart](https://docs.lucanto.eu/quickstart.md): From zero to your first authenticated request
- [Authentication](https://docs.lucanto.eu/authentication.md): Token types, scopes, and how access is enforced
- [Pagination](https://docs.lucanto.eu/pagination.md): Cursor-based paging on list endpoints
- [Idempotency](https://docs.lucanto.eu/idempotency.md): Safe retries on POST requests
- [Errors](https://docs.lucanto.eu/errors.md): The canonical error envelope
- [MCP server](https://docs.lucanto.eu/mcp.md): Connect Claude, Cursor, or ChatGPT to your Lucanto workspace
- [Changelog](https://docs.lucanto.eu/home/changelog/changelog.md): Keep your users updated as your project evolves
- [Changelog (all entries)](https://docs.lucanto.eu/home/changelog/changelog/llms.txt)
- [API reference](https://docs.lucanto.eu/api-reference.md): Interactive reference for the Lucanto REST API

## API Docs

- API Reference > Bank Accounts [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 Account Notification Preferences [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 Statements [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 [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 > Contacts [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 > Credit Notes [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 > Dashboard [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 > Devices [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 > Document Settings [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 > Invoices [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 > Proformas [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 > Quotes [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 > Registry [Look up a company in the business register](https://docs.lucanto.eu/api-reference/api-reference/registry/lookup.md)
- API Reference > Sales Orders [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 > Suppliers [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 > Tax [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 > Transactions [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 > User [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 > Workspaces [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)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.lucanto.eu/openapi.json)
- [OpenAPI YAML](https://docs.lucanto.eu/openapi.yaml)