ConnectCloud Developers

Work entries of a team member (line managers and deputies, hr:work:manage)

GET /api/hr/v1/employees/{id}/work-entries

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

Like listWorkEntries for the employee in the path; people the caller does not decide for answer 404.

Parameters

Name In Type Required Description
subject query string Only the entries on this subject, every day, newest first (max length 200)
from query string (date)
to query string (date)
state query string (one of suggested, confirmed, approved, billed)
limit query integer 1–200; another value is a 400 invalid. (default 50; max 200)
offset query integer (default 0)
id path string (uuid) yes

Responses

  • 200 Entries (application/json)
  • 400 Error (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • items (array of WorkEntry, required): Entries of this page
    • 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)
  • total (integer): Number of all matching entries

Example 200 answer:

{
  "items": [
    {
      "approvedAt": "2026-11-17T08:05:00Z",
      "approvedBy": "martin.brandl@muster-it.example",
      "billableMinutes": 15,
      "billing": "quota",
      "contract": {
        "id": "7a9c1e3a-5c7e-4a9c-8e3a-5c7e9a1c3e52",
        "number": "WV-2026-0007",
        "quota": true,
        "title": "Wartungsvertrag Netzwerk und WLAN"
      },
      "createdAt": "2026-11-16T09:30:00Z",
      "createdBy": "sophie.huber@muster-it.example",
      "customer": {
        "id": "3c5e7a9c-1d3f-4b5a-9c7e-1a3c5e7a9c1e",
        "name": "Alpenhotel Seeblick GmbH"
      },
      "description": "Access Point im Restaurant neu gestartet, Kanal gewechselt, Rückruf bei Frau Stadler.",
      "durationSeconds": 900,
      "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
      "endedAt": "2026-11-16T09:27:00Z",
      "id": "5e7a9c1e-3a5c-4e7a-9c1e-3a5c7e9a1c51",
      "kind": "remote",
      "minutes": 15,
      "origin": "comms:interaction:4f6a8c0e-2b4d-4f6a-8c0e-2b4d6f8a0c2e",
      "running": false,
      "source": "interaction",
      "startedAt": "2026-11-16T09:12:00Z",
      "state": "approved",
      "subject": "desk:item:6a8c0e2a-4b6d-4f8a-9c1e-3b5d7f9a1c3e",
      "subjectLabel": "#214 WLAN im Restaurant fällt aus",
      "updatedAt": "2026-11-17T08:05:00Z",
      "version": 2,
      "workDate": "2026-11-16"
    },
    {
      "billableMinutes": 0,
      "billing": "none",
      "createdAt": "2026-11-16T15:10:00Z",
      "createdBy": "sophie.huber@muster-it.example",
      "description": "Teambesprechung Service Desk",
      "durationSeconds": 2700,
      "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
      "endedAt": null,
      "id": "7a9c1e3a-5c7e-4a9c-9e3a-5c7e9a1c3e53",
      "kind": "internal",
      "minutes": 45,
      "running": false,
      "source": "manual",
      "startedAt": null,
      "state": "confirmed",
      "subject": "",
      "updatedAt": "2026-11-16T15:10:00Z",
      "version": 1,
      "workDate": "2026-11-16"
    }
  ],
  "total": 2
}

Example request

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

View as Markdown · Interactive reference · OpenAPI