Quickstart

From zero to your first authenticated request

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/accounts \
>   -H "Authorization: Bearer lct_pat_xxx"

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

3. List invoices

$ curl https://app.lucanto.eu/api/v1/accounts/{account_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:

Authentication — token types and scopes
Pagination — walking next_cursor
Errors — handling non-2xx responses

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

$	curl https://app.lucanto.eu/api/v1/accounts/{account_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	}