API Reference
API Reference

/work_schedules

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

🚧

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

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!