Working-time models of an employee, oldest first (hr:read, the person themself, or their managers and deputies)
GET /api/hr/v1/employees/{id}/schedules
Module: HR · operationId: listEmployeeSchedules · Tag: Working time · Auth: access token (Authorization: Bearer <accessToken>)
Managers and deputies read the models of the people in their chain of command; people outside their scope answer 404.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Responses
- 200 Models (
application/json) - 404 Error (
application/json)
Fields of the 200 answer:
items(array of WorkSchedule, required): Working-time models, oldest firstdayMinutes(array of integer, required): Target minutes Monday … SundayvacationDays(number, required): Vacation days per yearvalidFrom(string (date), required): First day the model applies (YYYY-MM-DD)createdAt(string (date-time), read-only): When the model was savedcreatedBy(string, read-only): Who saved the model (e-mail)employeeId(string, read-only): Id of the employeefederalState(string): Overrides the tenant's Bundeslandid(string, read-only): Id of the working-time model
Example 200 answer:
{
"items": [
{
"createdAt": "2025-10-20T11:00:00Z",
"createdBy": "clara.becker@muster-it.example",
"dayMinutes": [
300,
300,
300,
300,
300,
0,
0
],
"employeeId": "d1f3b5c7-9e1a-4d3f-8b5c-7a9e1f3b5d08",
"federalState": "BY",
"id": "9e1a3c5e-7a9c-4e1a-8c3e-7a9c1e3a5c34",
"vacationDays": 28,
"validFrom": "2025-11-03"
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/employees/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/schedules' \
-H "Authorization: Bearer $ACCESS_TOKEN"