The caller's day – attendance, work entries, totals and what is not booked yet (tenant:access)
GET /api/hr/v1/my-day
Module: HR · operationId: getMyDay · Tag: Work entries · Auth: access token (Authorization: Bearer <accessToken>)
„Mein Tag“: the attendance day of the timesheet, the finished work entries of the work day (corrections
included) and the running stopwatch, the totals (attended = the attendance's actual time, booked,
billable, internal, gap = max(0, attended − booked); suggestions do not count) and the open items – the
caller's calls, meetings and remote sessions (not internal) and Microsoft 365 appointments (not all-day) that
are not booked yet, oldest first; private appointments without a label. comms is asked with the e-mail of the
caller's employee record. comms failing never fails the page: openUnavailable is set and open keeps what
arrived; openTruncated when comms listed only part of the day. Without an employee record 403 no_employee.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
date |
query | string (date) | Day (default today in the tenant's time zone) |
Responses
- 200 The day (
application/json) - 400 Error (
application/json) - 403 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/my-day' \
-H "Authorization: Bearer $ACCESS_TOKEN"