Monthly overview (hr:time:manage for everybody, managers for their team)
GET /api/hr/v1/time-accounts
Module: HR · operationId: listTimeAccounts · Tag: Working time · Auth: access token (Authorization: Bearer <accessToken>)
Without hr:time:manage only the people the caller is responsible for; 403 when that is nobody.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
month |
query | string | ||
groupId |
query | string | ||
orgUnitId |
query | string | Only people of this org unit | |
subUnits |
query | boolean | Include the unit's sub-units | |
team |
query | string | mine = only the people the caller is responsible for (one of mine) |
|
limit |
query | integer | 1–200; another value is a 400 invalid. (default 50; max 200) |
|
offset |
query | integer | (default 0) |
Responses
- 200 A page of employees, by name (
application/json)
Fields of the 200 answer:
items(array of TimeAccountRow): Employees of this pagebalance(integer): Time account balance in minutes at the end of the month (up to yesterday for the current month)closed(boolean): The month is closed for the employeeemployeeId(string): Id of the employeeemployeeName(string): Display name of the employeesickDays(number): Sick days in the monthtotals(TimeTotals): Minutes. target, actual, break, credit and delta sum the counted days only (counted: before today in the tenant's time zone – a past month counts every day, a future month none); today and later days count once they are overactual(integer): Worked minutes of the counted daysbreak(integer): Break minutes of the counted dayscredit(integer): Minutes absences count as worked, on the counted daysdelta(integer): actual + credit − target of the counted days, in minutesmonthTarget(integer): Target minutes of every day of the month (counted or not)target(integer): Target minutes of the counted days (up to yesterday)violations(integer): Number of working-time rule warnings (every day, today included)
vacationDays(number): Vacation days taken in the month
month(string): The month (YYYY-MM)total(integer): Number of all matching employees
Example 200 answer:
{
"items": [
{
"balance": 310,
"closed": false,
"employeeId": "c7e9a1b3-5d7f-4b2c-8e4a-6f8b0d2c4e06",
"employeeName": "Elias Gruber",
"sickDays": 2,
"totals": {
"actual": 9720,
"break": 600,
"credit": 960,
"delta": 120,
"monthTarget": 10560,
"target": 10560,
"violations": 1
},
"vacationDays": 0
},
{
"balance": 135,
"closed": false,
"employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
"employeeName": "Sophie Huber",
"sickDays": 0,
"totals": {
"actual": 9255,
"break": 570,
"credit": 1440,
"delta": 135,
"monthTarget": 10560,
"target": 10560,
"violations": 0
},
"vacationDays": 3
}
],
"month": "2026-10",
"total": 2
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/time-accounts' \
-H "Authorization: Bearer $ACCESS_TOKEN"