Get a contact | Lucanto | Documentation

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.

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.

idlongRequired>=1

Contact ID

Response

OK

idlong

Contact ID (workspace-scoped)

created_atdatetime

updated_atdatetime

namestring or null<=255 characters

Display name of the contact (model allows nil; typically present)

ratestring or nullformat: "decimal"

Default hourly/unit rate applied on quotes/invoices for this contact. Returned as a string to preserve decimal precision (Stripe-style). On write, accepts either a number or a stringified number.

due_daysinteger or null

Default payment terms in days. Applied to issued documents.

invoice_account_idlong

ID of the linked InvoiceAccount (the shared legal-entity registry) that holds the contact’s legal name, registration ID, VAT ID, and addresses.

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

1	{
2	"id": 1,
3	"created_at": "2024-01-15T09:30:00Z",
4	"updated_at": "2024-01-15T09:30:00Z",
5	"name": "ACME s.r.o.",
6	"rate": "15.50",
7	"due_days": 14,
8	"invoice_account_id": 1
9	}

1	{
2	"id": 1,
3	"created_at": "2024-01-15T09:30:00Z",
4	"updated_at": "2024-01-15T09:30:00Z",
5	"name": "ACME s.r.o.",
6	"rate": "15.50",
7	"due_days": 14,
8	"invoice_account_id": 1
9	}

$	curl https://app.lucanto.eu/api/v1/accounts/42/contacts/1 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"