ConnectCloud Developers

Today's attendance of the signed-in user

GET /api/hr/v1/attendance/status

Module: HR · operationId: getAttendanceStatus · Tag: Working time · Auth: access token (Authorization: Bearer <accessToken>)

Responses

  • 200 Attendance (application/json)

Fields of the 200 answer:

  • breakMinutes (integer): Break minutes today so far
  • employeeId (string): Id of the employee (empty without an active employee record)
  • employeeName (string): Display name of the employee
  • registered (boolean): The caller has an active employee record (false: nothing else is filled)
  • since (string (date-time)): When the current state began (clock-in or break start)
  • status (string): Current attendance state (one of CLOCKED_IN, ON_BREAK, CLOCKED_OUT)
  • targetMinutes (integer): Today's target minutes
  • workedMinutes (integer): Minutes worked today so far

Example 200 answer:

{
  "breakMinutes": 0,
  "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
  "employeeName": "Sophie Huber",
  "registered": true,
  "since": "2026-11-19T06:31:00Z",
  "status": "CLOCKED_IN",
  "targetMinutes": 480,
  "workedMinutes": 145
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/hr/v1/attendance/status' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI