Skip to main content
GET
/
schedule
/
api
/
working-time-arrangements
/
{workingTimeArrangementId}
Get a Working Time Arrangement by id.
curl --request GET \
  --url https://{host}/schedule/api/working-time-arrangements/{workingTimeArrangementId} \
  --header 'Authorization: <authorization>'
{
  "id": 1,
  "name": "<string>",
  "description": "<string>",
  "unit": "day",
  "referencePeriod": {
    "frequencyType": "week",
    "firstDayOfWeek": "monday"
  },
  "contractWorkingTimeDuration": {
    "value": 1,
    "iso": "<string>",
    "unit": "days"
  },
  "referenceWorkingTimeDuration": {
    "value": 1,
    "iso": "<string>",
    "unit": "days"
  },
  "fullTimeEquivalent": 0.5,
  "fullDayAbsenceDurationInHours": 1,
  "publicHolidaysCalendar": {
    "id": 1,
    "name": "<string>"
  },
  "isPartTime": true,
  "isArchived": true,
  "isScheduleValid": true,
  "currentAssignmentsCount": 123,
  "timesheetRegulation": {
    "id": 1,
    "name": "<string>"
  },
  "currentSchedulePatternSummary": {
    "shape": "singleWeek",
    "days": [
      {
        "dayOffType": "off",
        "workPosition": "firstHalf",
        "workDuration": 1
      }
    ]
  },
  "authorizedCommands": [
    "create"
  ]
}

Headers

​
Authorization
string
required

API key. Value must be formatted like so: lucca application={api_key}.

Path Parameters

​
workingTimeArrangementId
integer
required

The unique identifier of the Working Time Arrangement.

Required range: x >= 0

Response

OK

A working time arrangement is an object aimed at drawing employees populations regarding time management rules.

It is attached to employees through their work contract and essentially dictates:

  • their contractual working time, ie how many hours / days they are paid for each week / year.
  • a full time equivalent based on the the ratio between this contractual work duration and a "full time work duration".
  • a succession of Collective Schedules that describe their usual working hours.
  • the applicable regulation in Lucca Timesheet.
​
id
integer
required

The unique identifier of this Working Time Arrangement.

Required range: x >= 0
​
name
string
required

The unique name for this Working Time Arrangement.

Required string length: 3 - 1000
​
description
string | null
required

An optional description.

Maximum length: 5000
​
unit
enum<string>
required

An event can be set in:

  • Day: "I worked for a half day last Monday".
  • Hour: "I worked for 2 hours last Monday".
  • Time: "I worked between 10:00 AM and 12:00 AM last Monday".
Available options:
day,
hour,
time
​
fullTimeEquivalent
number
required

By default, equal to the ratio between the Contract Working Time Duration and the Reference Working Time Duration.

Required range: 0 <= x <= 1Must be a multiple of 0.0001
​
publicHolidaysCalendar
object
required

Unique identifier of the Public Holidays Calendar applicable to these employees.

​
isPartTime
boolean
required

True whenever the Full Time Equivalent is below 1 (eg <100%).

​
isArchived
boolean
required

True whenever this Working Time Arrangement should no longer be given to employees.

​
isScheduleValid
boolean
required

False if there is not at least one Collective Schedule. In this case, the Working Time Arrangement can't be given to any employee through his Work Contract.

​
authorizedCommands
enum<string>[]
required

The actions the current authenticated User can make on this Working Time Arrangement. Depends on his permissions.

​
referencePeriod
object | null

The period the Contract Working Time Duration applies over.

  • Week
  • Year
​
contractWorkingTimeDuration
object

How many hours / days these employees are paid for every Reference Period?

​
referenceWorkingTimeDuration
object

The number of hours / days for a full-time employee over the same Reference Period.

​
fullDayAbsenceDurationInHours
number | null

Duration in hours of a full day of absence. When left null, is equal to the number of hours indicated on the given day in the applicable Collective Schedule.

Required range: x >= 0Must be a multiple of 0.0001
​
currentAssignmentsCount
integer
​
timesheetRegulation
object

The applicable Lucca Timesheet regulation, which contains all rules regarding time tracking management in this application.

​
currentSchedulePatternSummary
object

A summary of the expected working hours, given the currently ongoing Schedule Pattern.