ConnectCloud Developers

A team member's day (line managers and deputies, hr:work:manage)

GET /api/hr/v1/employees/{id}/my-day

Module: HR · operationId: getEmployeeMyDay · Tag: Work entries · Auth: access token (Authorization: Bearer <accessToken>)

Like getMyDay for the employee in the path. For another person open is empty (people book only for themselves) and the attendance is shown only to who sees it under the attendance rules (hr:time:manage, line managers and deputies); with hr:work:manage alone attendanceHidden is set, attendance empty and attendedMinutes/gapMinutes are 0. The caller's own id answers like getMyDay, open items included. People the caller does not decide for answer 404.

Parameters

Name In Type Required Description
date query string (date) Day (default today in the tenant's time zone)
id path string (uuid) yes

Responses

  • 200 The day (application/json)
  • 400 Error (application/json)
  • 403 Error (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • attendance (TimesheetDay, required): One day of a timesheet (minutes)
    • absence (object): The absence on the day, if any
      • fraction (number): Share of the day the absence covers (1 or 0.5)
      • id (string): Id of the absence
      • status (string): State of the absence
      • typeId (string): Id of the absence type
    • actual (integer): Worked minutes
    • break (integer): Break minutes
    • counted (boolean): The day lies before today (tenant time zone) and counts in the totals and the time account. Today shows its live target, actual and credit but is not counted yet; later days show their target only
    • credit (integer): Minutes absences count as worked
    • date (string (date)): The day (YYYY-MM-DD)
    • delta (integer): actual + credit − target, in minutes; 0 on days not counted (today and later)
    • entries (array of TimeEntry): Time entries of the day
      • autoEnded (boolean): HR ended the segment at midnight because nobody clocked out (setting autoEndAtMidnight). It counts no working time until it is corrected; any change clears the mark.
      • breakMinutes (integer): Break inside the segment in minutes (manual entries)
      • createdAt (string (date-time)): When the time entry was created
      • createdBy (string): Who created the time entry (e-mail of the caller)
      • employeeId (string): Id of the employee
      • end (string (date-time)): Missing while running
      • endedForBreak (boolean): The segment was closed by starting a break
      • id (string): Id of the time entry
      • note (string): Note on the entry
      • source (string): clock: stamped, manual: entered by hand (one of clock, manual)
      • start (string (date-time)): Start of the segment
      • updatedAt (string (date-time)): When the time entry was last changed
      • updatedBy (string): Who last changed the time entry (e-mail of the caller)
      • version (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
    • holiday (Holiday)
      • custom (boolean): A holiday of the tenant's own (omitted when false)
      • date (string (date)): Date (YYYY-MM-DD)
      • fraction (number): 1 for a full day, 0.5 for a half day (e.g. 24.12.) (one of 0.5, 1)
      • name (string): Name of the holiday
    • running (boolean): A segment of the day is still open
    • target (integer): Scheduled minutes (minus holidays and unpaid absences)
    • violations (array of Violation): Working-time rule warnings (ArbZG); never blocking
      • breakMinutes (integer): Break that counts under §4 ArbZG: interruptions of 15 minutes or more plus booked breaks (break_6h, break_9h)
      • code (string): auto_ended is no ArbZG rule: a segment HR ended at midnight whose times need checking (one of break_6h, break_9h, max_10h, rest_11h, sunday_holiday, open_entry, auto_ended)
      • entryId (string): The open or auto-ended entry (open_entry, auto_ended)
      • excessMinutes (integer): Worked time above the maximum (max_10h)
      • message (string): Human-readable text of the warning (German)
      • requiredMinutes (integer): Limit of the rule: required break (30/45), maximum worked time (600) or minimum rest (660)
      • restMinutes (integer): Rest since the previous work (rest_11h)
      • since (string (date-time)): End of the previous work (rest_11h) or start of the open or auto-ended entry (open_entry, auto_ended)
      • workedMinutes (integer): Worked time of the day (break_6h, break_9h, max_10h, sunday_holiday)
  • attendanceHidden (boolean, required): The caller sees the work but not the attendance of this person (hr:work:manage alone): attendance is empty, attended and gap minutes are 0
  • date (string (date), required): The day (YYYY-MM-DD)
  • employeeId (string (uuid), required): Id of the employee
  • entries (array of WorkEntry, required): Finished entries of the work day, corrections included
    • approvedAt (string (date-time), nullable): When the entry was approved
    • approvedBy (string): Who approved the entry (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)
    • article (WorkArticleRef | null): Masterdata article a flat-rate entry is billed as
    • batchId (string (uuid), nullable): Billing batch the entry is billed in
    • billableMinutes (integer): Minutes billed
    • billedRate (number, nullable): Hourly rate (or article price) the entry was billed at
    • billing (string): Key of a billing type
    • contract (WorkContractRef | null): Trade contract that decides billing
    • correctionOf (string (uuid), nullable): The approved or billed entry this one corrects; its minutes are the difference (may be negative)
    • createdAt (string (date-time)): When the work entry was created
    • createdBy (string): Who booked the entry (e-mail)
    • customer (WorkCustomerRef | null): Customer the work is billed to
    • description (string): What was done
    • durationSeconds (integer): The exact length in seconds (the stopwatch's seconds, else minutes × 60)
    • employeeId (string (uuid)): Id of the employee
    • employeeName (string): Display name of the employee – only in listApprovableWorkEntries
    • endedAt (string (date-time), nullable): null for the running stopwatch and for an entry without a span
    • id (string (uuid)): Id of the work entry
    • kind (string): Key of a work kind (getWorkEntrySettings)
    • km (number): Kilometres travelled (kinds that allow travel)
    • minutes (integer): The length in minutes that sums and billing use (a correction's difference, may be negative; 0 for a stopwatch run that rounded to nothing)
    • origin (string): The call or appointment the time comes from: comms:interaction:<id> or comms:calendar:<id>; omitted for other work. Booked at most once per tenant (409 already_booked)
    • project (WorkProjectRef | null): Project the work counts for
    • running (boolean): The running stopwatch entry (start, no end)
    • source (string): How the entry was booked (one of manual, stopwatch, interaction, calendar, correction)
    • startedAt (string (date-time), nullable): null for an entry booked as a length only
    • state (string): suggested → confirmed → approved → billed (one of suggested, confirmed, approved, billed)
    • subject (string): What was worked on: desk:item:<id>, forge:item:<id>, crm:activity:<id>, a project desk:project:<id> / forge:project:<id>; empty for work on the customer only or internal work
    • subjectLabel (string): The subject's name at booking time (the origin's without a subject)
    • travelMinutes (integer): Travel time in minutes (kinds that allow travel)
    • updatedAt (string (date-time)): When the work entry was last changed
    • version (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
    • workDate (string (date)): The day the work counts for (the person's choice; with a start its day in the tenant's time zone)
  • open (array of OpenItem, required): Not booked yet (own day only)
    • customer (WorkCustomerRef | null, required): The customer comms suggests
    • end (string (date-time), required): End
    • kind (string, required): Kind of the item (one of call, meeting, remote_session, calendar)
    • label (string, required): Subject or other side; empty for a private appointment (busy time)
    • private (boolean, required): A private appointment (no label)
    • start (string (date-time), required): Start
    • subject (string, required): comms:interaction:<id> or comms:calendar:<id>
  • openTruncated (boolean, required): comms listed only part of the day
  • openUnavailable (boolean, required): comms could not be asked; open holds what arrived
  • running (WorkEntry | null, required): The running stopwatch entry, whatever day it started
  • totals (MyDayTotals, required)
    • attendedMinutes (integer, required): The attendance's actual time
    • billableMinutes (integer, required): Billable minutes of the finished entries
    • bookedMinutes (integer, required): Finished entries, corrections with their sign (as getWorkSummary)
    • gapMinutes (integer, required): max(0, attended − booked)
    • internalMinutes (integer, required): Booked on non-billable billing types

Example 200 answer:

{
  "attendance": {
    "actual": 145,
    "break": 0,
    "counted": false,
    "credit": 0,
    "date": "2026-11-19",
    "delta": 0,
    "entries": [
      {
        "autoEnded": false,
        "breakMinutes": 0,
        "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
        "endedForBreak": false,
        "id": "5c7e9a1c-3e5a-4c7e-8a9c-3e5a7c9e1a37",
        "source": "clock",
        "start": "2026-11-19T06:31:00Z",
        "version": 1
      }
    ],
    "running": true,
    "target": 480,
    "violations": []
  },
  "attendanceHidden": false,
  "date": "2026-11-19",
  "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
  "entries": [
    {
      "billableMinutes": 0,
      "billing": "none",
      "createdAt": "2026-11-19T07:21:00Z",
      "createdBy": "sophie.huber@muster-it.example",
      "description": "Ticket-Queue gesichtet und verteilt",
      "durationSeconds": 2700,
      "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
      "endedAt": "2026-11-19T07:20:00Z",
      "id": "0f2b4d6f-8b0d-4f2b-9d6f-8b0d2f4b6d57",
      "kind": "internal",
      "minutes": 45,
      "running": false,
      "source": "manual",
      "startedAt": "2026-11-19T06:35:00Z",
      "state": "confirmed",
      "subject": "",
      "updatedAt": "2026-11-19T07:21:00Z",
      "version": 1,
      "workDate": "2026-11-19"
    }
  ],
  "open": [
    {
      "customer": {
        "id": "1b3d5f7b-9d1f-4b3d-8f5b-9d1f3b5d7f50",
        "name": "Kanzlei Hofmann \u0026 Partner"
      },
      "end": "2026-11-19T08:13:00Z",
      "kind": "call",
      "label": "Florian Pichler",
      "private": false,
      "start": "2026-11-19T08:05:00Z",
      "subject": "comms:interaction:2d4f6b8d-0f2b-4d4f-8b8d-0f2b4d6f8b56"
    }
  ],
  "openTruncated": false,
  "openUnavailable": false,
  "running": {
    "billableMinutes": 0,
    "billing": "hourly",
    "createdAt": "2026-11-19T08:40:00Z",
    "createdBy": "sophie.huber@muster-it.example",
    "customer": {
      "id": "1b3d5f7b-9d1f-4b3d-8f5b-9d1f3b5d7f50",
      "name": "Kanzlei Hofmann \u0026 Partner"
    },
    "description": "Drucker im Empfang einrichten",
    "durationSeconds": 0,
    "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
    "endedAt": null,
    "id": "9c1e3a5c-7e9a-4c1e-8a5c-7e9a1c3e5a54",
    "kind": "remote",
    "minutes": 0,
    "running": true,
    "source": "stopwatch",
    "startedAt": "2026-11-19T08:40:00Z",
    "state": "confirmed",
    "subject": "desk:item:8c0e2a4c-6e8a-4c0e-9a2c-4e6a8c0e2a55",
    "subjectLabel": "#231 Neuer Drucker am Empfang",
    "updatedAt": "2026-11-19T08:40:00Z",
    "version": 1,
    "workDate": "2026-11-19"
  },
  "totals": {
    "attendedMinutes": 145,
    "billableMinutes": 0,
    "bookedMinutes": 45,
    "gapMinutes": 100,
    "internalMinutes": 45
  }
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/hr/v1/employees/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/my-day' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI