# Lucca API ## Docs - [Features](https://developers.lucca.fr/api-reference/legacy/api-generations.md): Features of the Legacy API, and the differences between v3 and v4 API generations. - [Authentication](https://developers.lucca.fr/api-reference/legacy/authentication.md): Learn how to authenticate on a Legacy API. - [Legacy API Changelog](https://developers.lucca.fr/api-reference/legacy/changelog.md) - [The expense-claim-item resource](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenseclaimitems/expense-claim-item.md) - [Get an ExpenseClaimItem by id](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenseclaimitems/get-an-expenseclaimitem-by-id.md): Retrieve an expense claim item by its identifier. - [List ExpenseClaimItems](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenseclaimitems/list-expense-claim-items.md): Retrieve a list of `expenseClaimItems`. - [Create a new ExpenseClaim](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenseclaims/create-a-new-expenseclaim.md): When a user wants to declare his expenses, he creates an `ExpenseClaim`. - [The expense-claim resource](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenseclaims/expense-claim.md) - [List ExpenseClaims](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenseclaims/list-expenseclaims.md): Retrieve a list of `ExpenseClaims`. - [Create a new temporary expense](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenses/create-a-new-temporary-expense.md): Create a new temporary-expense-item. - [The expense-temp-item resource](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenses/expense-temp-item.md) - [Get an ExpenseTempItem by id](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenses/get-an-expensetempitem-by-id.md): Retrieve an temporary expense item by its identifier. - [List ExpenseTempItems](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenses/list-expensetempitems-temporary-expense.md): Retrieve a list of `ExpenseTempItems`. - [Update an ExpenseTempItem by id](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/expenses/update-an-expensetempitem-by-id.md): Update a temporary expense item by its identifier. - [Create an export and retrieve export content](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/exports/post-create-expense-accounting-export.md): Create a new export and retrieve the export content directly in the response body for a given business-establishment. - [Learn about expenses custom fields](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/guides/about-custom-fields.md): When configuring Lucca Expenses, you may add custom fields to `expense-temp-items` and `expense-claim-items`. - [Attaching receipts to expenses](https://developers.lucca.fr/api-reference/legacy/cleemy-expenses/guides/attaching-receipts.md): Learn how to upload a receipt file and attach it to an expense when using the Expenses API. - [The booked-document resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/booked-documents/booked-document.md) - [List booked-documents](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/booked-documents/get-booked-documents.md): List booked-documents (i.e. invoices and credit notes). - [The cost-center resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/cost-centers/cost-center.md) - [Get Cost-Center](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/cost-centers/get-cost-center.md): Retrieve a cost-center by its ID. - [List Cost-Centers](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/cost-centers/get-cost-centers.md): List cost-centers. - [Import Cost-Centers](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/cost-centers/import-cost-centers.md): Import a list of cost-centers. Endpoint to use for bulk import of cost-centers. - [Create a Cost-Center](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/cost-centers/post-cost-center.md): Create a new cost-center. - [Update Cost-Center](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/cost-centers/put-cost-center.md): Update a cost-center. - [Delete Document](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/documents/delete-document.md): Delete a document. - [The document resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/documents/document.md) - [Get Document](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/documents/get-document.md): Retrieve a document by its ID. - [Update Document](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/documents/put-document.md): Update a document's information (e.g. accounting fields, amounts, supplier details) before booking it. - [Create an approved order](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/guides/create-approved-order.md): Learn how to create an approved Order in Lucca Invoices - [Import cost-centers](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/guides/import-cost-centers.md): Use our API dedicated to import cost centers within Lucca Invoices - [Process an invoice automatically](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/guides/process-invoice-automatically.md): Retrieve inbox documents, update their information, and book them via the API - [Retrieve processed invoices](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/guides/retrieve-processed-invoices.md): Learn how to retrieve already processed invoices from Lucca Invoices to sync them with your ERP - [The inbox-document resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/inbox/inbox-document.md) - [List Inbox Documents](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/inbox/inbox-document/get-inbox-documents.md): List documents waiting to be processed in the inbox. - [Book an Inbox Document](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/inbox/inbox-document/post-inbox-document-booking.md): Book (validate) a document from the inbox. No request body is needed. - [Update Inbox Document](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/inbox/inbox-document/put-inbox-document.md): Update an inbox document and optionally attach or create a purchase. - [Get Invoice](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/invoices/get-invoice.md): Retrieve an invoice by its ID. - [List Invoice Confirmations](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/invoices/get-invoice-confirmations.md): List confirmations for an invoice. - [The invoice resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/invoices/invoice.md) - [Confirm an Invoice](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/invoices/post-invoice-confirmation.md): Confirm (approve) an invoice. - [Update Invoice](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/invoices/put-invoice.md): Update an invoice. - [Get Nature](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/natures/get-nature.md): Retrieve a nature by its ID. - [List Natures](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/natures/get-natures.md): List natures. - [The nature resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/natures/nature.md) - [Create a Nature](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/natures/post-nature.md): Create a new nature. - [Update Nature](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/natures/put-nature.md): Update a nature. - [The commitment resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/commitment.md) - [Get Purchase](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/get-purchase.md): Retrieve a purchase by its ID. - [List Purchases](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/get-purchases.md): List purchases. - [List V.A.T. rates](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/get-vat-rates.md): List V.A.T. rates. - [Create a Purchase](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/post-purchase.md): Create a Purchase. - [Close a purchase](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/post-purchase-closing.md): Close a purchase - [Create a commitment](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/post-purchase-commitment.md): Create a commitment. - [The purchase resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/purchases/purchase.md) - [Get Supplier](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/suppliers/get-supplier.md): Retrieve a supplier by its ID. - [List Suppliers](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/suppliers/get-suppliers.md): List suppliers. - [Create a Supplier](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/suppliers/post-supplier.md): Create a new supplier. - [Update Supplier](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/suppliers/put-supplier.md): Update a supplier. - [The supplier resource](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/suppliers/supplier.md) - [Create a commitment request](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/workflow/post-commitment-request.md): Trigger the approval workflow for a purchase commitment. Request body is expected to be empty. - [Cancel a commitment-request](https://developers.lucca.fr/api-reference/legacy/cleemy-invoices/workflow/post-commitment-request-cancellation.md): Cancel a commitment-request. - [Create a new User](https://developers.lucca.fr/api-reference/legacy/directory/create-a-new-user.md): Create a new user - [Delete a work-contract](https://developers.lucca.fr/api-reference/legacy/directory/delete-work-contract.md): Delete a work-contract by its ID. - [Get a User by Id](https://developers.lucca.fr/api-reference/legacy/directory/get-a-user-by-id.md): Retrieve a single User identified by its unique identifier. - [Retrieve a work-contract](https://developers.lucca.fr/api-reference/legacy/directory/get-work-contract.md): Retrieve a single work-contract by its ID. - [List work-contracts](https://developers.lucca.fr/api-reference/legacy/directory/get-work-contracts.md): Retrieve a paginated collection of work-contracts. - [Delegation](https://developers.lucca.fr/api-reference/legacy/directory/guides/delegation.md) - [Extended Data](https://developers.lucca.fr/api-reference/legacy/directory/guides/extended-data.md) - [Using the user-properties API](https://developers.lucca.fr/api-reference/legacy/directory/guides/user-properties.md): The UserProperties API can be used to retrieve information on the structure of all the properties that can be attached to a user. This API is read-only: only the HTTP `GET` request method is therefore available on this API. - [Users Examples](https://developers.lucca.fr/api-reference/legacy/directory/guides/users.md) - [V3 Users to V5 Employees](https://developers.lucca.fr/api-reference/legacy/directory/guides/users-migration.md): Migration steps from the legacy /api/v3/users endpoint to the Lucca API employee resources. - [V4 Work-Contracts to V5 Employments & Job-Positions](https://developers.lucca.fr/api-reference/legacy/directory/guides/work-contracts-migration.md): Migration steps from /directory/api/4.0/work-contracts to the Lucca API employment and job-position resources. - [List Users](https://developers.lucca.fr/api-reference/legacy/directory/list-users.md): Retrieve a list of Users. - [Update a work-contract](https://developers.lucca.fr/api-reference/legacy/directory/patch-work-contract.md): Update a work-contract by its ID. - [Create a work-contract](https://developers.lucca.fr/api-reference/legacy/directory/post-work-contract.md): Create a new work-contract. - [Update a User by id](https://developers.lucca.fr/api-reference/legacy/directory/update-a-user-by-id.md): Update fields of a single User identified by its unique id. - [The user resource](https://developers.lucca.fr/api-reference/legacy/directory/user.md) - [The work-contract resource](https://developers.lucca.fr/api-reference/legacy/directory/work-contract.md) - [The file resource](https://developers.lucca.fr/api-reference/legacy/files/file.md) - [Upload a file](https://developers.lucca.fr/api-reference/legacy/files/post-upload.md): Upload a file. - [Using Files](https://developers.lucca.fr/api-reference/legacy/files/using-files.md) - [Introduction](https://developers.lucca.fr/api-reference/legacy/introduction.md): Precursors to the Lucca API. - [Limits](https://developers.lucca.fr/api-reference/legacy/limits.md) - [The axis resource](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/axis.md) - [The axis-section resource](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/axis-section.md) - [Create a new AxisSection](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/create-a-new-axissection.md): Create a new AxisSection. - [Delete an AxisSection by id](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/delete-an-axissection-by-id.md): Delete an AxisSection by id - [Get an AxisSection by id](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/get-an-axissection-by-id.md): Retrieve a single AxisSection by its unique identifier. - [Get Started With Axis-Sections](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/get-started.md): Learn more about axes & axis-sections. - [List Axes](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/list-axes.md): List all Axes satisfying query filters. - [List AxisSections](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/list-axissections.md): List all AxisSections satisfying query filters. - [Update an AxisSection by id](https://developers.lucca.fr/api-reference/legacy/organization/axis-sections/update-an-axissection-by-id.md): Partial or complete update to an existing AxisSection. - [The department resource](https://developers.lucca.fr/api-reference/legacy/organization/departments/department.md) - [The department resource](https://developers.lucca.fr/api-reference/legacy/organization/departments/department-v4.md) - [Get Departement by id (v3)](https://developers.lucca.fr/api-reference/legacy/organization/departments/get-departement-by-id-v3.md): Retrieve a single Department by its unique identifier. - [List Departements as a tree](https://developers.lucca.fr/api-reference/legacy/organization/departments/list-departements-as-a-tree.md): List all departments as a tree. Remark: first node is always empty and represents the starting point of the tree as multiple departments might be set to the highest level. - [List departments](https://developers.lucca.fr/api-reference/legacy/organization/departments/list-departments.md): List departments. - [List Departments (v3)](https://developers.lucca.fr/api-reference/legacy/organization/departments/list-departments-v3.md): List all Departments satisfying query filters. - [Retrieve a department](https://developers.lucca.fr/api-reference/legacy/organization/departments/retrieve-a-department.md): Retrieve a department by its ID. - [The establishment resource](https://developers.lucca.fr/api-reference/legacy/organization/establishments/establishment.md) - [List establishments](https://developers.lucca.fr/api-reference/legacy/organization/establishments/list-establishments.md): Retrieve a list of establishments. - [Migrating Departments to the Lucca API (v5)](https://developers.lucca.fr/api-reference/legacy/organization/guides/departments-migration.md): Migration steps from the V3 or V4 departments APIs to the Lucca API (v5) department resource. - [Migrating to Lucca API (v5) Business-Establishments & Legal-Entities](https://developers.lucca.fr/api-reference/legacy/organization/guides/establishments-migration.md): Migration steps from V3 legal-entities or V4 establishments to the Lucca API (v5) business-establishments and legal-entities. - [The legal-unit resource](https://developers.lucca.fr/api-reference/legacy/organization/legal-units/legal-unit.md) - [List legal-units](https://developers.lucca.fr/api-reference/legacy/organization/legal-units/list-legal-units.md): Retrieve a paginated list of legal-units. - [Retrieve a computation's details](https://developers.lucca.fr/api-reference/legacy/pagga-mealvouchers/computation/retrieve-a-computations-details.md): A computation's details indicate the number of meal voucher to be given to each employee subject to the applicable statutory. - [List a statutory's distributions](https://developers.lucca.fr/api-reference/legacy/pagga-mealvouchers/statutory/list-a-statutorys-distributions.md): Retrieve all distributions of a specific statutory - [List statutories](https://developers.lucca.fr/api-reference/legacy/pagga-mealvouchers/statutory/list-statutories.md): Retrieve all existing statutories. A statutory is the object that contains the application settings. - [Retrieve a statutory](https://developers.lucca.fr/api-reference/legacy/pagga-mealvouchers/statutory/retrieve-a-statutory.md): Retrieve a single statutory by its ID. - [Retrieve a statutory's parameters](https://developers.lucca.fr/api-reference/legacy/pagga-mealvouchers/statutory/retrieve-a-statutorys-parameters.md): Retrieve all general parameters of a specific statutory - [The fixed-item resource](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-items/fixed-item.md) - [List fixed items](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-items/list-fixed-items.md): Retrieve fixed remuneration items matching a set of filters - [The fixed-nature resource](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-natures/fixed-nature.md) - [The fixed-nature-category resource](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-natures/fixed-nature-category.md) - [Get a fixed nature](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-natures/get-fixed-nature.md): Retrieve a single fixed nature from its identifier - [List fixed nature categories](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-natures/list-fixed-nature-categories.md): List fixed-nature categories. - [List fixed natures](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/fixed-natures/list-fixed-natures.md): Retrieve all existing fixed natures - [Create a variable item](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-items/create-variable-item.md): Create a new variable item attached to an employee work contract. - [Delete a variable-item](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-items/delete-variable-item.md): Delete a variable-item. - [Retrieve a variable item](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-items/get-variable-item.md): Retrieve a single variable item by id. - [List variable items](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-items/list-variable-items.md): Retrieve variable remuneration items matching a set of filters - [Update a variable-item](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-items/update-variable-item.md): Update a variable-item. - [The variable-item resource](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-items/variable-item.md) - [Get a variable nature](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-natures/get-variable-nature.md): Retrieve a single variable nature from its identifier - [List variable nature categories](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-natures/list-variable-nature-categories.md): List variable-nature-categories - [List variable natures](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-natures/list-variable-natures.md): Retrieve all existing variable natures - [The variable-nature resource](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-natures/variable-nature.md) - [The variable-nature-category resource](https://developers.lucca.fr/api-reference/legacy/pagga-remuneration/variable-natures/variable-nature-category.md) - [Create a completed course in Lucca](https://developers.lucca.fr/api-reference/legacy/poplee-training/guides/create-a-completed-course-in-lucca.md): Learn how to create a completed course in Lucca for all your employees. This is useful for consolidating all completed courses, regardless of where they took place—for example, courses from an e-learning LMS platform. This integration simplifies how managers and employees track completed courses and… - [Create a training](https://developers.lucca.fr/api-reference/legacy/poplee-training/guides/create-a-training.md): Learn how to create a new training with the state ‘ready’ in Lucca training. - [Delete a realized-training (v2)](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/delete-realized-training-v2.md): Delete a realized training by its id. - [Get a realized-training (v2)](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/get-realized-training-v2.md): Retrieve a single realized-training by its id. - [List realized-trainings (v2)](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/get-realized-trainings-v2.md): Retrieve a paginated list of realized trainings. It includes all realized trainings that have been manually imported via CSV file, imported through the process in Lucca Training, or created via the API. - [List realized-trainings](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/list-realized-trainings.md): Retrieve a paginated list of realized-trainings for all employees who were present at a closed session. It also includes all realized training that have been manually imported via CSV file into Lucca Training. - [Create a realized-training (v2)](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/post-realized-trainings-v2.md): Create a new realized training. It must refer to a training that is in the 'ready' state, and the sessionEndsOn date must be in the past. It is also not possible to create two realized trainings for the same employee with the same trainingId and sessionEndsOn. - [The realized-training resource](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/realized-training.md) - [The realized-training (v2) resource](https://developers.lucca.fr/api-reference/legacy/poplee-training/realized-trainings/realized-training-v2.md) - [List training-demands](https://developers.lucca.fr/api-reference/legacy/poplee-training/training-demands/list-training-demands.md): Retrieve a paginated list of training-demands that satisfy the query filters. - [The training-demand resource](https://developers.lucca.fr/api-reference/legacy/poplee-training/training-demands/training-demand.md) - [List trainings](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/get-trainings-v1.md): Retrieve a paginated list of trainings. - [List training-categories](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/list-training-categories.md): Retrieve a paginated list of training-categories. - [List training-providers](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/list-training-providers.md): Retrieve a paginated list of training-providers. - [Create a training](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/post-training-v1.md): Creates a training with the state 'ready', which by default is not displayed in the public catalog. - [The training-category resource](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/training-category.md) - [The training-provider resource](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/training-provider.md) - [The training resource](https://developers.lucca.fr/api-reference/legacy/poplee-training/trainings/training-v1.md) - [The application resource](https://developers.lucca.fr/api-reference/legacy/recruitment/applications/application.md) - [Create a new application for a job opportunity](https://developers.lucca.fr/api-reference/legacy/recruitment/applications/post-application.md): This route allows creating a new application for a job opportunity, given candidate information. - [List active job offers](https://developers.lucca.fr/api-reference/legacy/recruitment/job-offers/get-job-offers.md): Returns an XML file containing company metadata and a list of all currently open job positions. - [Get Started With Job-Offers](https://developers.lucca.fr/api-reference/legacy/recruitment/job-offers/job-offer.md) - [Assign a Working Time Arrangement to an Employee](https://developers.lucca.fr/api-reference/legacy/schedule/employee-assignments/assign-working-time-arrangement-to-employee.md): You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support. - [The employee-assignment resource](https://developers.lucca.fr/api-reference/legacy/schedule/employee-assignments/employee-assignment.md) - [List Employee Assignments](https://developers.lucca.fr/api-reference/legacy/schedule/employee-assignments/list-employee-assignments.md): You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support. - [List UserDates.](https://developers.lucca.fr/api-reference/legacy/schedule/userdates/list-userdates.md): Retrieve a list of UserDates. - [The user-date resource](https://developers.lucca.fr/api-reference/legacy/schedule/userdates/userdate.md) - [Create (or update) a WorkCycleException.](https://developers.lucca.fr/api-reference/legacy/schedule/workcycle-exceptions/create-workcycle-exception.md): **⚠️ Note**: An employee can only have a single `WorkCycleException` on any given half-day (indicated by the `startsAt` date and the `isAm` boolean). As a result, creating a new `WorkCycleException` via a POST request may result in the update of the existing one. - [Delete a WorkCycleException.](https://developers.lucca.fr/api-reference/legacy/schedule/workcycle-exceptions/delete-workcycle-exception.md): **❗Note**: The `WorkCycleException`, once deleted, stays available in the API. In order to filter out the deleted `WorkCycleException`, you may use the `deletedAt` query parameter: ```http GET /api/v3/workcycleexceptions?deletedAt=null HTTPS/1.1 Host: example.ilucca.net Authorization: lucca applicat… - [Retrieve a WorkCycleException.](https://developers.lucca.fr/api-reference/legacy/schedule/workcycle-exceptions/get-workcycle-exception.md): Retrieve a single WorkCycleException by its ID. - [List WorkCycleExceptions.](https://developers.lucca.fr/api-reference/legacy/schedule/workcycle-exceptions/list-workcycle-exceptions.md): Retrieve a paginated list of WorkCycleExceptions that satisfy the given query filters. - [The workcycle-exception resource](https://developers.lucca.fr/api-reference/legacy/schedule/workcycle-exceptions/workcycle-exception.md) - [The collective-schedule resource](https://developers.lucca.fr/api-reference/legacy/schedule/working-time-arrangements/collective-schedule.md) - [Get a Collective Schedule from a Working Time Arrangement by id.](https://developers.lucca.fr/api-reference/legacy/schedule/working-time-arrangements/get-collective-schedule.md): **This is a beta feature.** You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support. - [Get a Working Time Arrangement by id.](https://developers.lucca.fr/api-reference/legacy/schedule/working-time-arrangements/get-working-time-arrangement.md): **This is a beta feature.** You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support. - [List Collective Schedules from a Working Time Arrangement](https://developers.lucca.fr/api-reference/legacy/schedule/working-time-arrangements/list-collective-schedules.md): **This is a beta feature.** You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support. - [List Working Time Arrangements.](https://developers.lucca.fr/api-reference/legacy/schedule/working-time-arrangements/list-working-time-arrangements.md): You may not benefit from this feature. Working-time-arrangements are the replacement for the workcycles. If this feature has not been deployed on your environment, please contact our support. - [The working-time-arrangement resource](https://developers.lucca.fr/api-reference/legacy/schedule/working-time-arrangements/working-time-arrangement.md) - [Migrate from leaves v2](https://developers.lucca.fr/api-reference/legacy/timmi-absences/guides/migrate-from-leaves-v2.md) - [Syncing leaves](https://developers.lucca.fr/api-reference/legacy/timmi-absences/guides/syncing-leaves.md) - [Get import leaves progress](https://developers.lucca.fr/api-reference/legacy/timmi-absences/imports/get-import-leaves-progress.md): Retrieve the progress of Import leaves API request. - [Import entitlements](https://developers.lucca.fr/api-reference/legacy/timmi-absences/imports/import-entitlements.md): **Supported file formats:** - CSV - "UTF-8" encoding - separator “;” - XSLX - [Import leaves](https://developers.lucca.fr/api-reference/legacy/timmi-absences/imports/import-leaves.md): Create absences in batch from a CSV file. - [Replace entitlements](https://developers.lucca.fr/api-reference/legacy/timmi-absences/imports/replace-entitlements.md): **Supported file formats:** - CSV - "UTF-8" encoding - separator “;” - XSLX - [Approve or deny a leave request](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/approve-or-deny-a-leave-request.md): Approve or deny a single Leave Request by its unique identifier - [The cancellation-request resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/cancellation-request.md) - [Get a leave request by id](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/get-a-leave-request-by-id.md): Retrieve a single Leave Request by its unique identifier. - [The leave-period resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/leave-period.md) - [The leave-request resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/leave-request.md) - [The leave-request-approval resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/leave-request-approval.md) - [List leave requests](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/list-leave-requests.md): Retrieve a list of Leave Requests. - [Request to cancel a leave request](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leave-requests/request-to-cancel-a-leave-request.md): Request to cancel a single Leave Request by its unique identifier - [Cancellation of a leave](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leaves/cancellation-of-a-leave.md): Cancel a single Leave by its unique identifier. - [Get a leave by id](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leaves/get-a-leave-by-id.md): Retrieve a single Leave by its unique identifier. - [The leave resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leaves/leave.md) - [The leave-account resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leaves/leave-account.md) - [List leaves](https://developers.lucca.fr/api-reference/legacy/timmi-absences/leaves/list-leaves.md): Retrieve a list of approved leaves for one or several users on a given period. - [Get a SickLeaveCertificate](https://developers.lucca.fr/api-reference/legacy/timmi-absences/sick-leave-certificates/get-sick-leave-certificate.md): Retrieve a single SickLeaveCertificate. - [List SickLeaveCertificates](https://developers.lucca.fr/api-reference/legacy/timmi-absences/sick-leave-certificates/list-sick-leave-certificates.md): Retrieve a paginated list of SickLeaveCertificate objects, which contain further information about certain types of leaves. - [The SickLeaveCertificate resource](https://developers.lucca.fr/api-reference/legacy/timmi-absences/sick-leave-certificates/sick-leave-certificate.md) - [Import user locations](https://developers.lucca.fr/api-reference/legacy/timmi-office/guides/import-and-create-user-locations.md) - [Get import user locations analysis](https://developers.lucca.fr/api-reference/legacy/timmi-office/imports/get-import-user-locations-analysis.md): Retrieve the analysis of the Import User Locations API request with the create parameter set to false. - [Get import user locations progress](https://developers.lucca.fr/api-reference/legacy/timmi-office/imports/get-import-user-locations-progress.md): Retrieve the progress of the Import User Locations API request. - [Get import user locations results](https://developers.lucca.fr/api-reference/legacy/timmi-office/imports/get-import-user-locations-results.md): Retrieve the results of the Import User Locations API request with the create parameter set to true. - [Import user locations](https://developers.lucca.fr/api-reference/legacy/timmi-office/imports/import-user-locations.md): Create user locations in batch from a CSV file. - [Get specific userLocation](https://developers.lucca.fr/api-reference/legacy/timmi-office/user-locations/get-user-location.md): Get specific userLocation by id - [List userLocations](https://developers.lucca.fr/api-reference/legacy/timmi-office/user-locations/list-user-locations.md): Query employees work locations - [The user-location resource](https://developers.lucca.fr/api-reference/legacy/timmi-office/user-locations/user-location.md) - [Retrieve specific workLocation](https://developers.lucca.fr/api-reference/legacy/timmi-office/work-locations/get-work-location.md): Get a specific work location by id - [List workLocations](https://developers.lucca.fr/api-reference/legacy/timmi-office/work-locations/list-work-locations.md): Query all available work locations - [The work-location resource](https://developers.lucca.fr/api-reference/legacy/timmi-office/work-locations/work-location.md) - [The client resource](https://developers.lucca.fr/api-reference/legacy/timmi-project/clients/client.md) - [Create a new Client](https://developers.lucca.fr/api-reference/legacy/timmi-project/clients/create-a-new-client.md): Create a new client. - [Delete a Client by id](https://developers.lucca.fr/api-reference/legacy/timmi-project/clients/delete-a-client-by-id.md): Delete a single client. Deletion is irrevocable. - [Get a Client by id](https://developers.lucca.fr/api-reference/legacy/timmi-project/clients/get-a-client-by-id.md): Retrieve a single client identified by its unique identifier. - [List Clients](https://developers.lucca.fr/api-reference/legacy/timmi-project/clients/list-clients.md): List clients from an organization. - [Update a Client by id](https://developers.lucca.fr/api-reference/legacy/timmi-project/clients/update-a-client-by-id.md): Update fields of a single client identified by its unique id. - [List financials by project](https://developers.lucca.fr/api-reference/legacy/timmi-project/financials/list-financials-by-project.md): Retrieve all financial metrics on projects. - [The project-financials resource](https://developers.lucca.fr/api-reference/legacy/timmi-project/financials/project-financials.md) - [List Organizations](https://developers.lucca.fr/api-reference/legacy/timmi-project/organizations/list-organizations.md): List organizations. - [The organization resource](https://developers.lucca.fr/api-reference/legacy/timmi-project/organizations/organization.md) - [Create a new Project Service](https://developers.lucca.fr/api-reference/legacy/timmi-project/project-services/create-a-new-project-service.md): Create a new Project Service on a project. - [List a Project's Services](https://developers.lucca.fr/api-reference/legacy/timmi-project/project-services/list-a-projects-services.md): List all services from a project identified by its unique id. - [The project-service resource](https://developers.lucca.fr/api-reference/legacy/timmi-project/project-services/project-service.md) - [Create a new Project](https://developers.lucca.fr/api-reference/legacy/timmi-project/projects/create-a-new-project.md): Create a new Project - [Delete a Project by id](https://developers.lucca.fr/api-reference/legacy/timmi-project/projects/delete-a-project-by-id.md): Only projects at "draft" status can be deleted. - [Get Project by id](https://developers.lucca.fr/api-reference/legacy/timmi-project/projects/get-project-by-id.md): Retrieve a project by its unique identifier. - [List Projects](https://developers.lucca.fr/api-reference/legacy/timmi-project/projects/list-projects.md): List projects from an organization. Only returns a subset of a [Project](reference/Timmi-Project.yaml/components/schemas/Project) fields. - [The project resource](https://developers.lucca.fr/api-reference/legacy/timmi-project/projects/project.md) - [Update a Project by id](https://developers.lucca.fr/api-reference/legacy/timmi-project/projects/update-a-project-by-id.md): Update an existing Project. - [How to Download Reports](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/download-report.md) - [Export from Lucca Timesheet](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/exports.md): Learn how to use the export feature of Lucca Timesheet through the API. In particular, **how to generate a new export and retrieve its content**. - [How to Mass Delete TimeEntries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/mass-deletion-timeentries.md) - [How to Reject Timesheets](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/mass-rejection-timesheets.md) - [How to Submit Timesheets](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/mass-submit-timesheets.md) - [How To Retrieve TimeEntries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/retrieve-time-entries.md) - [How to Update TimeEntries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/guides/update-time-entries.md) - [Create a new Report](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/reports/create-a-report.md): This endpoint does not adhere to the "v3 API endpoints" principles. The "fields" query parameter is not supported, but all fields are systematically returned. - [Download Report as CSV](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/reports/download-report-as-csv.md): This endpoint does not adhere to the "v3 API endpoints" principles. The "fields" query parameter is not supported, but all fields are systematically returned. - [Download Report as Excel](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/reports/download-report-as-excel.md): This endpoint does not adhere to the "v3 API endpoints" principles. The "fields" query parameter is not supported, but all fields are systematically returned. - [The report resource](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/reports/report.md) - [Create new time-entries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/create-new-timeentries.md): Create one or multiple time-entries. - [Delete a time-entry by id](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/delete-a-time-entry-by-id.md): Delete a time-entry. Deletion is irrevocable. - [Delete multiple time-entries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/delete-multiple-timeentries.md): Delete one or several time-entries. Deletion is irrevocable. - [Get a time-entry by id](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/get-a-timeentry-by-id.md): Retrieve a single time-entry identified by its unique identifier. - [TimeEntries update service](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/import-time-entries.md): ## Before using this service - [List multiple time-entries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/list-timeentries.md): List all time-entries satisfying query filters. - [The time-entry resource](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/time-entry.md) - [Update a time-entry by id](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/update-a-time-entry-by-id.md): Update fields of a single time-entry identified by its unique id. - [Update multiple time-entries](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/time-entries/update-multiple-timeentries.md): Update one or several time-entries. - [List due timesheets](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/timesheets/list-due-timesheets.md): List timesheets that are not yet submitted (status: 0). - [List timesheets](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/timesheets/list-timesheets.md): List all timesheets satisfying query filters. - [The timesheet resource](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/timesheets/timesheet.md) - [Approve a timesheet](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/approve-timesheet.md): Approve once the timesheet referenced by its ID, and any timesheets before it pending approval belonging to the same timesheet owner. - [Cancel a timesheet](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/cancel-timesheet.md): Cancel a timesheet referenced by its ID, and any timesheets after it pending approval belonging to the same timesheet owner. - [Deny a timesheet](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/deny-timesheet.md): Deny a timesheet with a mandatory comment. - [Invalidate a timesheet](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/invalidate-timesheet.md): Invalidate a timesheet with a mandatory comment. - [Remind Timesheets](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/remind-timesheets.md): Remind users of a due timesheet. Sends him/her an email. - [Submit timesheets](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/submit-timesheets.md): Submit all timesheets for an owner up to the given period, or to the last submittable timesheet. - [The transfer object](https://developers.lucca.fr/api-reference/legacy/timmi-timesheet/workflow/transfer.md) - [Lucca Developers Hub](https://developers.lucca.fr/home.md) ## OpenAPI Specs - [lucca-api@2024-11-01](https://developers.lucca.fr/openapi-specs/lucca-api@2024-11-01.json) - [webhook-client-api](https://developers.lucca.fr/openapi-specs/webhook-client-api.json) - [timmi-timesheet](https://developers.lucca.fr/openapi-specs/timmi-timesheet.yaml) - [timmi-timesheet-v3](https://developers.lucca.fr/openapi-specs/timmi-timesheet-v3.yaml) - [timmi-project](https://developers.lucca.fr/openapi-specs/timmi-project.yaml) - [timmi-absences-v3](https://developers.lucca.fr/openapi-specs/timmi-absences-v3.yaml) - [schedule](https://developers.lucca.fr/openapi-specs/schedule.yaml) - [recruitment](https://developers.lucca.fr/openapi-specs/recruitment.yaml) - [recruitment-world](https://developers.lucca.fr/openapi-specs/recruitment-world.yaml) - [poplee-training](https://developers.lucca.fr/openapi-specs/poplee-training.yaml) - [organization-v3](https://developers.lucca.fr/openapi-specs/organization-v3.yaml) - [authentication](https://developers.lucca.fr/openapi-specs/authentication.yaml) - [lucca-invoices](https://developers.lucca.fr/openapi-specs/lucca-invoices.yaml) - [cleemy-expenses-v3](https://developers.lucca.fr/openapi-specs/cleemy-expenses-v3.yaml) - [directory-v3](https://developers.lucca.fr/openapi-specs/directory-v3.yaml) - [pagga-remuneration](https://developers.lucca.fr/openapi-specs/pagga-remuneration.yaml) - [timmi-office](https://developers.lucca.fr/openapi-specs/timmi-office.yaml) - [lucca-files](https://developers.lucca.fr/openapi-specs/lucca-files.yaml) - [Pagga-MealVoucher](https://developers.lucca.fr/openapi-specs/Pagga-MealVoucher.yaml) - [lucca-api-nav](https://developers.lucca.fr/lucca-api-nav.json) - [openapi](https://developers.lucca.fr/api-reference/openapi.json) - [timmi-absences.bundle](https://developers.lucca.fr/_oas-bundles/timmi-absences.bundle.yaml) - [lucca-api.bundle](https://developers.lucca.fr/_oas-bundles/lucca-api.bundle.yaml) - [lucca-api-internal.bundle](https://developers.lucca.fr/_oas-bundles/lucca-api-internal.bundle.yaml) ## Optional - [Community](https://join.slack.com/t/luccaapicommunity/shared_invite/zt-32njiaefl-QjdcZ8JGfPEO_y6BdJh3lg) - [Status](https://status.lucca.fr)