ConnectCloud Developers

Entries the caller may approve (line managers and deputies for their team, hr:work:manage for everyone)

GET /api/hr/v1/work-entries/approvals

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

Finished entries of every employee the caller decides for: with hr:work:manage everyone's, otherwise the team's of a line manager or deputy (nobody else: an empty page). The caller's own entries only with hr:work:manage and the tenant's selfApproval. state=approved lists approvals to take back. The period defaults to the 31 days before to (default today), at most a year. Each entry carries the person's employeeName.

Parameters

Name In Type Required Description
state query string (one of confirmed, approved; default "confirmed")
from query string (date)
to query string (date)
limit query integer 1–200; another value is a 400 invalid. (default 50; max 200)
offset query integer (default 0)

Responses

  • 200 Entries by work day (application/json)
  • 400 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/work-entries/approvals' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI