API reference
Interactive reference for the Lucanto REST API
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,
which is assembled by the deployed API.
Conventions
- Base URL:
https://app.lucanto.eu/api/v1 - Auth:
Authorization: Bearer <token>— see 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 - Errors: standard errors use a uniform envelope; feature limits carry an actionable
code— see Errors - Retries:
POSTsupports theIdempotency-Keyheader — see 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.

