For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Get API key
HomeAPI Reference
HomeAPI Reference
  • Overview
    • API reference
  • API Reference
      • GETList quotes
      • POSTCreate a quote
      • GETGet a quote
      • DELSoft-delete a quote
      • PATCHUpdate a quote
      • POSTMark a quote as accepted by the customer
Get API key
LogoLogo
API ReferenceQuotes

List quotes

||View as Markdown|
GET
https://app.lucanto.eu/api/v1/accounts/:account_id/quotes
GET
/api/v1/accounts/:account_id/quotes
$curl https://app.lucanto.eu/api/v1/accounts/42/quotes \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "next_cursor": "eyJpZCI6MTI0fQ==",
3  "has_more": true,
4  "data": [
5    {
6      "id": 124,
7      "type": "quote",
8      "status": "active",
9      "valid_until": "2024-05-10",
10      "currency": "EUR",
11      "created_at": "2024-04-10T09:00:00Z",
12      "updated_at": "2024-04-11T09:00:00Z",
13      "number": "CEN2024-0042",
14      "issue_date": "2024-04-10",
15      "delivery_date": "2024-04-15",
16      "exchange_rate": "1.0000",
17      "included_in_turnover": true,
18      "discount_description": "Spring promotion 10% off",
19      "discount_percentage": "10.00",
20      "discount_amount": "50.00",
21      "text_opening": "Thank you for considering our services.",
22      "text_closing": "We look forward to your confirmation.",
23      "footer_note": "Prices exclude VAT unless stated otherwise.",
24      "recipient_note": "Please review the terms carefully.",
25      "internal_note": "Priority client, follow up next week.",
26      "pdf_language": "en",
27      "pdf_locale": "en-GB",
28      "pdf_compact_mode": false,
29      "hide_signature": false,
30      "delivery_type": "email",
31      "sent_status": "sent",
32      "email_sent_at": "2024-04-10T10:15:00Z",
33      "seen_timestamp": "2024-04-11T08:30:00Z",
34      "purchaser_id": 501,
35      "supplier_id": 42,
36      "bank_account_id": 7,
37      "project_id": 88,
38      "document_items": [
39        {
40          "id": 1001,
41          "name": "Premium Website Design",
42          "description": "Complete redesign of corporate website with responsive layout",
43          "order": 1,
44          "quantity": "1",
45          "measure_unit": "service",
46          "unit_price": "500.00",
47          "vat_rate": "21.00",
48          "discount_description": "10% spring discount",
49          "discount_percentage": "10.00",
50          "discount_unit_price": "450.00",
51          "created_at": "2024-04-10T09:00:00Z",
52          "updated_at": "2024-04-10T09:00:00Z"
53        }
54      ],
55      "purchaser": {
56        "id": 501,
57        "registration_id": "12345678",
58        "tax_id": "CZ123456789",
59        "vat_id": "CZ123456789",
60        "vat_payer_type": "standard",
61        "vat_period": "monthly",
62        "email": "contact@clientcompany.com",
63        "phone_number": "+420123456789",
64        "web": "https://clientcompany.com",
65        "invoice_address": {
66          "id": 301,
67          "name": "Client Company HQ",
68          "contact": "Jan Novak",
69          "street": "Vinohradská 123",
70          "municipality": "Prague",
71          "postal_code": "13000",
72          "country_id": 203
73        },
74        "postal_address": {
75          "id": 302,
76          "name": "Client Company HQ",
77          "contact": "Jan Novak",
78          "street": "Vinohradská 123",
79          "municipality": "Prague",
80          "postal_code": "13000",
81          "country_id": 203
82        }
83      },
84      "supplier": {
85        "id": 42,
86        "registration_id": "87654321",
87        "tax_id": "CZ987654321",
88        "vat_id": "CZ987654321",
89        "vat_payer_type": "standard",
90        "vat_period": "monthly",
91        "email": "info@lucanto.eu",
92        "phone_number": "+420987654321",
93        "web": "https://lucanto.eu",
94        "invoice_address": {
95          "id": 10,
96          "name": "Lucanto s.r.o.",
97          "contact": "Petr Svoboda",
98          "street": "Na Příkopě 15",
99          "municipality": "Prague",
100          "postal_code": "11000",
101          "country_id": 203
102        },
103        "postal_address": {
104          "id": 11,
105          "name": "Lucanto s.r.o.",
106          "contact": "Petr Svoboda",
107          "street": "Na Příkopě 15",
108          "municipality": "Prague",
109          "postal_code": "11000",
110          "country_id": 203
111        }
112      }
113    }
114  ]
115}

Returns a cursor-paginated list of quotes for the workspace. Only documents with type=quote appear here — other document types have their own endpoints. Soft-deleted quotes are excluded. Ordered by id descending.

Was this page helpful?
Previous

Convert a proforma to a final invoice

Next

Create a quote

Built with

Authentication

AuthorizationBearer

Devise JWT issued via POST /api/v1/auth/sign_in. Used by mobile and SPA clients. Revoked tokens are tracked in api_jwt_denylists.

OR
AuthorizationBearer

Lucanto API key. Three prefixes:

  • lct_pat_<random><checksum> — personal access token (owner: User)
  • lct_live_<random><checksum> — workspace token, live data
  • lct_test_<random><checksum> — workspace token, sandbox account (Phase 3)

Issue keys at /settings/api_keys (personal) or /:account_id/settings/api_keys (workspace). Plaintext token is shown once and never again.

Path parameters

account_idlongRequired>=1

Workspace (account) ID. The numeric ID shown in your URLs.

Query parameters

cursorstringOptional

Pagination cursor from the previous response’s next_cursor.

limitintegerOptional1-100Defaults to 25
Number of items per page. Default 25, maximum 100.

Response

OK
next_cursorstring or null

Cursor to fetch the next page. Pass it as the cursor query parameter on the next request. null on the last page.

has_moreboolean
True when more pages exist after this one.
datalist of objects

Errors

401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
429
Too Many Requests Error