Get started

Quickstart

From zero to your first authenticated request
View as Markdown

1. Create an API key

In the Lucanto app, go to Settings → API keys and create a personal access token. The plaintext token is shown once — copy it immediately. It looks like:

lct_pat_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Choose scopes when you create the key. Start with read:invoices to follow this guide; you can issue a broader key later. See Authentication for the full scope list.

2. Find your workspace ID

Every endpoint is scoped to a workspace. List the workspaces your token can access:

$curl https://app.lucanto.eu/api/v1/user/workspaces \
>  -H "Authorization: Bearer lct_pat_xxx"

The id of the workspace you want is the workspace_id you’ll use below.

3. List invoices

$curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
>  -H "Authorization: Bearer lct_pat_xxx"
1{
2  "data": [
3    { "id": 123, "type": "invoice", "number": "FAK2026-0001", "status": "paid", "...": "..." }
4  ],
5  "next_cursor": "eyJpZCI6MTIzfQ==",
6  "has_more": true
7}

That’s it. From here: