API Reference

/work_schedules

Returns a collection of your account work_schedules. Required scope: r_account.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

🚧

This particular endpoint uses r_account scope, which can be enabled through the Integrations section found within the Settings menu.

Results

Calling the /work_schedules endpoint will return a collection of the defined work_schedules for the account. An example of the response follows:

[ { "id": "5c6", "name": "08:30 - 17:00 | 30' break", "status": "active", "work_days": [ { "day_of_week": "monday", "work_hours": "8.00", "break_duration": "00:30", "work_intervals": [ { "to_time": "17:00", "from_time": "08:30" } ], "break_intervals": [] }, { "day_of_week": "tuesday", "work_hours": "8.00", "break_duration": "00:30", "work_intervals": [ { "to_time": "17:00", "from_time": "08:30" } ], "break_intervals": [] }, { "day_of_week": "wednesday", "work_hours": "8.00", "break_duration": "00:30", "work_intervals": [ { "to_time": "17:00", "from_time": "08:30" } ], "break_intervals": [] }, { "day_of_week": "thursday", "work_hours": "8.00", "break_duration": "00:30", "work_intervals": [ { "to_time": "17:00", "from_time": "08:30" } ], "break_intervals": [] }, { "day_of_week": "friday", "work_hours": "8.00", "break_duration": "00:30", "work_intervals": [ { "to_time": "17:00", "from_time": "08:30" } ], "break_intervals": [] } ], "week_starts_on": "monday", "work_hours": "40.00" }, { "id": "5c7", "name": "Mon - Fri | 09.00 - 15.00 & 18.00 - 21.00 | 1h break", "status": "active", "work_days": [ { "day_of_week": "monday", "work_hours": "8.00", "break_duration": "01:00", "work_intervals": [ { "to_time": "15:00", "from_time": "09:00" }, { "to_time": "21:00", "from_time": "18:00" } ], "break_intervals": [] }, { "day_of_week": "tuesday", "work_hours": "8.00", "break_duration": "01:00", "work_intervals": [ { "to_time": "15:00", "from_time": "09:00" }, { "to_time": "21:00", "from_time": "18:00" } ], "break_intervals": [] }, { "day_of_week": "wednesday", "work_hours": "8.00", "break_duration": "01:00", "work_intervals": [ { "to_time": "15:00", "from_time": "09:00" }, { "to_time": "21:00", "from_time": "18:00" } ], "break_intervals": [] }, { "day_of_week": "thursday", "work_hours": "8.00", "break_duration": "01:00", "work_intervals": [ { "to_time": "15:00", "from_time": "09:00" }, { "to_time": "21:00", "from_time": "18:00" } ], "break_intervals": [] }, { "day_of_week": "friday", "work_hours": "8.00", "break_duration": "01:00", "work_intervals": [ { "to_time": "15:00", "from_time": "09:00" }, { "to_time": "21:00", "from_time": "18:00" } ], "break_intervals": [] } ], "week_starts_on": "monday", "work_hours": "40.00" } ]

Each work_schedule item will have the following keys:

keytypedescription
idstringThe work schedule identifier. Note that this id should be used when creating or updating an employee using the POST and PATCH endpoints respectively.
namestringThe name of the work schedule
statusstringThe status of the specific work schedule. Available values are active and archived

The other configuration objects are not relevant with the employee creation and only affect the time off calculations

Path Params
string
required

The account subdomain

Responses

Language
Credentials
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json