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 anyfraction(number): Share of the day the absence covers (1 or 0.5)id(string): Id of the absencestatus(string): State of the absencetypeId(string): Id of the absence type
actual(integer): Worked minutesbreak(integer): Break minutescounted(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 onlycredit(integer): Minutes absences count as workeddate(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 dayautoEnded(boolean): HR ended the segment at midnight because nobody clocked out (settingautoEndAtMidnight). 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 createdcreatedBy(string): Who created the time entry (e-mail of the caller)employeeId(string): Id of the employeeend(string (date-time)): Missing while runningendedForBreak(boolean): The segment was closed by starting a breakid(string): Id of the time entrynote(string): Note on the entrysource(string): clock: stamped, manual: entered by hand (one ofclock,manual)start(string (date-time)): Start of the segmentupdatedAt(string (date-time)): When the time entry was last changedupdatedBy(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 of0.5,1)name(string): Name of the holiday
running(boolean): A segment of the day is still opentarget(integer): Scheduled minutes (minus holidays and unpaid absences)violations(array of Violation): Working-time rule warnings (ArbZG); never blockingbreakMinutes(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 ofbreak_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:managealone):attendanceis empty, attended and gap minutes are 0date(string (date), required): The day (YYYY-MM-DD)employeeId(string (uuid), required): Id of the employeeentries(array of WorkEntry, required): Finished entries of the work day, corrections includedapprovedAt(string (date-time), nullable): When the entry was approvedapprovedBy(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 asbatchId(string (uuid), nullable): Billing batch the entry is billed inbillableMinutes(integer): Minutes billedbilledRate(number, nullable): Hourly rate (or article price) the entry was billed atbilling(string): Key of a billing typecontract(WorkContractRef | null): Trade contract that decides billingcorrectionOf(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 createdcreatedBy(string): Who booked the entry (e-mail)customer(WorkCustomerRef | null): Customer the work is billed todescription(string): What was donedurationSeconds(integer): The exact length in seconds (the stopwatch's seconds, elseminutes× 60)employeeId(string (uuid)): Id of the employeeemployeeName(string): Display name of the employee – only inlistApprovableWorkEntriesendedAt(string (date-time), nullable):nullfor the running stopwatch and for an entry without a spanid(string (uuid)): Id of the work entrykind(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>orcomms:calendar:<id>; omitted for other work. Booked at most once per tenant (409 already_booked)project(WorkProjectRef | null): Project the work counts forrunning(boolean): The running stopwatch entry (start, no end)source(string): How the entry was booked (one ofmanual,stopwatch,interaction,calendar,correction)startedAt(string (date-time), nullable):nullfor an entry booked as a length onlystate(string): suggested → confirmed → approved → billed (one ofsuggested,confirmed,approved,billed)subject(string): What was worked on:desk:item:<id>,forge:item:<id>,crm:activity:<id>, a projectdesk:project:<id>/forge:project:<id>; empty for work on the customer only or internal worksubjectLabel(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 changedversion(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 suggestsend(string (date-time), required): Endkind(string, required): Kind of the item (one ofcall,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): Startsubject(string, required):comms:interaction:<id>orcomms:calendar:<id>
openTruncated(boolean, required): comms listed only part of the dayopenUnavailable(boolean, required): comms could not be asked;openholds what arrivedrunning(WorkEntry | null, required): The running stopwatch entry, whatever day it startedtotals(MyDayTotals, required)attendedMinutes(integer, required): The attendance's actual timebillableMinutes(integer, required): Billable minutes of the finished entriesbookedMinutes(integer, required): Finished entries, corrections with their sign (asgetWorkSummary)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"