Lucca Fr Lucca HR API

Name: Lucca HR API
Brand: Lucca HR API
Availability: InStock

✓ Official Vendor SpecHR recruitingEmployee ManagementapiKey163 EndpointsREST

For Agents

Run Lucca HR workflows — directory, absences, time, expenses, meal vouchers, training, compensation, office, and project endpoints — across 163 operations behind an API key on the employer's ilucca.net instance.

Install Jentic One Beta

Connect the Lucca HR API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Lucca HR API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Lucca HR API.

Read and update the employee directory including departments, roles, and reporting lines

Submit and approve absence and leave records across the Lucca Absences module

Create, list, and update expense claims and individual expense items including receipts

GET STARTED

Start building with Lucca HR API

Explore with Jentic

View OpenAPI Document

Lucca is a French HR management platform whose API spans directory, time tracking, absences, expenses, training, compensation, office management, meal vouchers, invoicing, and project management. The 163 endpoints are tag-grouped by Lucca product (Lucca Absences, Lucca Expenses, Lucca Office, Lucca Project, Lucca Timesheet, Lucca Training, Lucca-Compensation, Lucca-MealVoucher, Lucca.Files, Directory) so integrations can scope to the modules an employer has activated. Authentication uses an API key sent in the Authorization header against the employer's own ilucca.net instance.

Use Cases

Patterns agents use Lucca HR API for, with concrete tasks.

★ Expense automation for French employers

Finance teams use Lucca's Expenses endpoints to ingest receipts, validate items, and roll them up into claims that trigger reimbursement payroll runs. The API distinguishes ExpenseTempItems (pending) from ExpenseClaimItems (committed), so an OCR pipeline can stage temporary items before the employee finalises a claim. Most teams ship the integration in a couple of weeks.

POST /api/v3/expenseTempItems for each OCR'd receipt, then POST /api/v3/expenseClaims/creation grouping the temp items for the employee.

Absence and leave self-service

HR portals call the Lucca Absences endpoints to let employees submit leave requests, view balances, and receive approvals — without the admin opening Lucca directly. The directory endpoints supply manager hierarchy so the right approver receives the request, and the Absences workflow handles the approval state transitions.

Look up the employee and their manager via Directory, then submit the absence request through Lucca Absences and notify the manager.

Meal-voucher reconciliation

Payroll teams reconcile monthly meal-voucher distributions using the statutory and computation endpoints. /mealvoucher/api/statutories lists the active statutories, the parameters endpoint exposes thresholds, and the computations endpoint returns per-employee detail so payroll can confirm totals before the bank file is generated. The dedicated MealVoucher tag keeps the workflow scoped.

GET /mealvoucher/api/statutories, then for each statutory iterate its distributions and computations to compile the monthly per-employee totals.

Project timesheet roll-up for client billing

Services firms use the Lucca Timesheet and Project endpoints to roll up billable hours by client and project before invoicing. The API exposes time entries against project codes, so the billing workflow extracts the week's entries, applies the client rate card, and produces the invoice line items without manual time-export.

Pull this week's time entries for a project, sum hours per employee, multiply by the rate card, and post invoice lines into the billing system.

Agent-driven HR concierge via Jentic

An AI HR concierge in a workplace chat answers questions like 'what is my remaining holiday?' and 'submit my expenses for last week' by calling Lucca through Jentic. The agent navigates the 10-product surface using Jentic's intent search rather than reading the developer portal, and the API key never enters the chat context.

Use Jentic to search 'submit lucca expense claim', load POST /api/v3/expenseClaims/creation, and execute it with the temp items the agent has already staged for the employee.

Key Endpoints

163 endpoints — lucca is a french hr management platform whose api spans directory, time tracking, absences, expenses, training, compensation, office management, meal vouchers, invoicing, and project management.

METHOD

PATH

DESCRIPTION

GET

/api/v3/expenseClaims

List expense claims

POST

/api/v3/expenseClaims/creation

Create a new expense claim

GET

/api/v3/expenseTempItems

List temporary expense items

POST

/api/v3/expenseTempItems

Create a temporary expense item

GET

/mealvoucher/api/statutories

List meal-voucher statutories

GET

/mealvoucher/api/statutories/{statutoryId}/distributions

List a statutory's distributions

GET

/mealvoucher/api/computations/{computationId}/details

Retrieve a meal-voucher computation's details

GET

/api/v3/expenseClaimItems

List expense claim items

GET

/api/v3/expenseClaims

List expense claims

POST

/api/v3/expenseClaims/creation

Create a new expense claim

GET

/api/v3/expenseTempItems

List temporary expense items

POST

/api/v3/expenseTempItems

Create a temporary expense item

GET

/mealvoucher/api/statutories

List meal-voucher statutories

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Lucca API keys are tenant-scoped — each employer has its own ilucca.net instance. Jentic stores the key and the instance hostname together encrypted in the vault, so the agent never holds either, and cross-tenant leakage is structurally prevented.

Intent-based discovery

Agents search by intent (for example 'submit a lucca expense claim' or 'list absences') and Jentic returns the matching Lucca operation with its input schema, so the agent does not need to know which of the 10 product tags owns the path.

Time to first call

Direct Lucca integration: 1-2 weeks for API-key handling, instance routing, and product-tag discovery. Through Jentic: under 1 hour — search by intent, load schema, execute against the right tenant.

FAQs

Specific to using Lucca HR API through Jentic.

What authentication does the Lucca HR API use?

Lucca uses an API key sent in the Authorization header (luccaApiKey scheme) against the employer's own ilucca.net instance — for example https://acme.ilucca.net. Through Jentic, the key and instance hostname are stored together in the vault so the agent only refers to 'the Lucca tenant for employer X'.

Can I submit an expense claim through the Lucca HR API?

Yes. Stage receipts as ExpenseTempItems via POST /api/v3/expenseTempItems, then group them into a claim with POST /api/v3/expenseClaims/creation. List endpoints (/api/v3/expenseClaims, /api/v3/expenseClaimItems) confirm the result before the manager approves.

What are the rate limits for the Lucca HR API?

Lucca enforces per-instance rate limits and returns HTTP 429 when exceeded; published guidance is to back off and retry. Because the API is partitioned by employer instance (each tenant on its own ilucca.net subdomain), one customer's traffic does not affect another's quota.

How do I list meal-voucher distributions through Jentic?

Search Jentic for 'list lucca meal voucher distributions', load GET /mealvoucher/api/statutories/{statutoryId}/distributions, and execute it with the statutory ID. Combine with GET /mealvoucher/api/statutories first to find the active statutory for the period.

Does the Lucca HR API cover compensation reviews?

Yes — the Lucca-Compensation tag exposes endpoints for compensation grids and review cycles, so a compensation tool can read current grids and post review outcomes back to Lucca.

How are the 163 Lucca endpoints organised?

By product tag — Directory, Lucca Absences, Lucca Expenses, Lucca Office, Lucca Project, Lucca Timesheet, Lucca Training, Lucca-Compensation, Lucca-MealVoucher, and Lucca.Files. When using Jentic, search by the intent ('submit expense claim') rather than navigating tags manually.

Lucca Fr Lucca HR API

Connect the Lucca HR API to your agent

Capabilities

Start building with Lucca HR API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs