ConnectCloud Developers

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:

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

View as Markdown · Interactive reference · OpenAPI