Absences from work, wether they are planned or not, are described in Lucca using three concepts : LeaveRequests, LeavePeriods and Leaves.

A LeaveRequest represent the request made by employees when planning time off. This resource is used for workflow purposes.

A LeavePeriod is the continuous period of absence requested by the employee or entered by HR. It is linked to a LeaveRequest if workflow applies.

A Leave is the subdivision of a LeavePeriod. There is one Leave per half-day of the LeavePeriod. Each Leave is linked to a LeaveAccount, which represent the type of leave (PTO, Sick Leave, Congés payés, RTT, etc).

LeaveRequests status are by default in the pending_approval state. LeaveRequests status can be approved, denied, cancelled or in the cancellation_pending state.

approvals
object[]
cancellationDate
string | null

Time at which the object was cancelled

cancellationRequests
object[]
cancellationUserId
integer | null

Unique identifier for the user that cancelled the Leave Request

creationDate
string

Time at which the object was created

id
integer

Unique identifier for the LeaveRequest

isActive
boolean

Has the value true for acitve Leave Request or the value false for cancelled Leave Request

leavePeriod
object
leavePeriodId
integer

Unique identifier for the attached LeavePeriod

nextApproverId
integer | null

Unique identifier for the next approver

status
enum<number>

Status of the Leave request. Can be :

0 = PENDING_APPROVAL

2 = APPROVED

3 = DENIED

4 = CANCELLED

5 = CANCELLATION_PENDING

Available options:
0,
2,
3,
4,
5