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"
{
  "data": [
    { "id": 123, "type": "invoice", "number": "FAK2026-0001", "status": "issued", "payment_status": "paid", "...": "..." }
  ],
  "next_cursor": "eyJpZCI6MTIzfQ==",
  "has_more": true
}

That’s it. From here: