Lucca HR API

Name: Lucca HR API 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.

Quickstart

Get started with Lucca HR API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"submit a lucca expense claim"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Lucca HR API 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

Manage meal-voucher statutories, distributions, and per-employee computations

GET STARTED

Start building with Lucca HR API API

Explore with Jentic

View OpenAPI Document

Use for: List all employees in a Lucca directory, Submit an expense claim for a specific employee, Approve a pending absence request, Get the meal-voucher distribution for an employee this month

Not supported: Does not handle French payroll bank-file generation, social-security filings, or non-French statutory rules — use for Lucca directory, absences, expenses, meal vouchers, time, training, compensation, and project operations only.

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 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 though 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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Personio API

European HR platform covering employees, absences, and basic payroll across multiple countries

Choose Personio for multi-country European employers; choose Lucca when the employer is French and needs the meal-voucher and France-specific modules.

Alternative

Factorial HR API

All-in-one HR platform covering people, time, and basic payroll across Europe

Use Factorial when the employer wants a single all-in-one HR product; use Lucca when modular adoption (just expenses, just time) is preferred.

Complementary

Loket.nl API

Dutch payroll engine that pairs with HR-of-record systems to handle Netherlands payroll

Pair Lucca (HR of record) with Loket (Dutch payroll) when an employer operates in both France and the Netherlands.

Complementary

Calendly API

Scheduling API for HR meetings, reviews, and onboarding sessions

Use Calendly alongside Lucca to book the meetings that follow Lucca workflow events such as new-hire onboarding or compensation reviews.

FAQs

Specific to using Lucca HR API 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.