> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.lucanto.eu/welcome/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.lucanto.eu/_mcp/server.

# Lucanto API

The Lucanto API lets you integrate invoicing, contacts, banking data, and
workspace workflows into your e-shop, accounting software, CRM, or custom
automation. The same scoped access can be handed to an AI agent over MCP.

#### [Quickstart](/quickstart)

Create an API key and make your first call in under five minutes.

#### [Authentication](/authentication)

Personal access tokens vs. workspace tokens, and how scopes work.

#### [Pagination](/pagination)

Cursor-based pagination for large collections.

#### [Idempotency](/idempotency)

Safe retries on POST with the Idempotency-Key header.

#### [Errors](/errors)

The canonical error envelope and how to handle it.

#### [MCP server](/mcp)

Connect Claude, Cursor, or ChatGPT to your Lucanto workspace.

## Base URL

All endpoints are served from:

```
https://app.lucanto.eu/api/v1
```

Most business resources are scoped to a workspace via the `workspace_id` path
segment, e.g. `GET /api/v1/workspaces/{workspace_id}/invoices`. User profile,
workspace discovery, registry lookup, and device registration are auth-scoped
and therefore do not carry a workspace ID.

> Programmatic access to invoices, contacts, banking, and workspace data