API reference

Interactive reference for the Lucanto REST API
View as Markdown

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: POST supports the Idempotency-Key header — 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.