## 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 page
  - `balance` (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 employee
  - `employeeId` (string): Id of the employee
  - `employeeName` (string): Display name of the employee
  - `sickDays` (number): Sick days in the month
  - `totals` (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 over
    - `actual` (integer): Worked minutes of the counted days
    - `break` (integer): Break minutes of the counted days
    - `credit` (integer): Minutes absences count as worked, on the counted days
    - `delta` (integer): actual + credit − target of the counted days, in minutes
    - `monthTarget` (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:

```json
{
  "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

```bash
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/time-accounts' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
