Working-time-arrangement
Get a Collective Schedule from a Working Time Arrangement by id.
Documentation
Organization Structure API
- Axis-sections
- Departments
- Legal-Units
- Establishments
Core HR API
- Employees Directory
- Guides
Cleemy Expenses API
- Expense-temp-items
- Expense-claims
- Expense-claim-items
- Exports
- Guides
Cleemy Invoices API
- Guides
Timmi Absences API
- Leaves
- Leave-requests
- Sick-leaves
- Imports
- Guides
Timmi Office API
- User-locations
- Work-locations
Timmi Project API
- Clients
- Projects
- Project services
- Organizations
- Financials
Timmi Settings API
- UserDates
- Workcycle-exceptions
- Working-time-arrangement
Timmi Timesheet API
- Time-entries
- Timesheets
- Reports
- Guides
Pagga Mealvouchers API
- Statutory
- Computation
Pagga Remuneration API
- Fixed-natures
- Fixed-items
- Variable-natures
- Variable-items
Poplee Training API
- Training-demands
- Realized-trainings
Working-time-arrangement
Get a Collective Schedule from a Working Time Arrangement by id.
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 Collective Schedule of a Working Time Arrangement by id
GET
/
timmi-settings
/
api
/
working-time-arrangements
/
{workingTimeArrangementId}
/
collective-schedules
/
{collectiveScheduleId}
curl --request GET \
--url https://{host}/timmi-settings/api/working-time-arrangements/{workingTimeArrangementId}/collective-schedules/{collectiveScheduleId} \
--header 'Authorization: <authorization>'
{
"id": 1,
"workingTimeArrangementId": 1,
"startsOn": "2023-12-25",
"endsOn": "2023-12-25",
"pattern": {
"shape": "singleWeek",
"monday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"tuesday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"wednesday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"thursday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"friday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"saturday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"sunday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
},
"splitsHalfDays": true
}
Headers
API key. Value must be formatted like so: lucca application={api_key}
.
Path Parameters
The unique identifier of the Working Time Arrangement.
Required range:
x >= 0
The unique identifier of the Collective Schedule for this Working Time Arrangement.
Response
200
application/json
OK
A Collective Schedule describes the employees' expected working hours over a week.
It comes in two shapes:
- "Single Week": Working hours are identical every week.
- "Odd / Even Weeks": Working hours depend on the oddness of the week.
curl --request GET \
--url https://{host}/timmi-settings/api/working-time-arrangements/{workingTimeArrangementId}/collective-schedules/{collectiveScheduleId} \
--header 'Authorization: <authorization>'
{
"id": 1,
"workingTimeArrangementId": 1,
"startsOn": "2023-12-25",
"endsOn": "2023-12-25",
"pattern": {
"shape": "singleWeek",
"monday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"tuesday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"wednesday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"thursday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"friday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"saturday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
},
"sunday": {
"id": 1,
"dayOffType": "off",
"shifts": [
{
"position": "firstHalf",
"startsAt": "<string>",
"duration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
],
"workDuration": {
"value": 1,
"iso": "<string>",
"unit": "days"
}
}
},
"splitsHalfDays": true
}