Einzelnes Stundenkonto abrufen

Liefert den zwischengespeicherten Überstundensaldo und Urlaubsanspruch eines einzelnen Mitarbeiters.

Verfügbarkeit: Vollversion und ZEP Clock

Request

GET /api/v1/workhour-balances/{id}

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/workhour-balances/{id}' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

Name
id
Type
integer
Description
Die ID des Stundenkontos

Response

{
  "data": {
    "id": 1,
    "employee_id": "max.mustermann",
    "balance": 1.5,
    "calculated_at": "2026-01-31T09:00:00.000000Z",
    "vacation": [
      {
        "year": "string",
        "approved": 12.5,
        "planned": 12.5,
        "remaining": 12.5,
        "annual_entitlement": 12.5
      }
    ]
  }
}

Response-Felder

Name
id
Type
integer
Description
Eindeutige Kennung des zwischengespeicherten Stundenkonto-Datensatzes.
Name
employee_id
Type
string
Description
Benutzername des Mitarbeiters, dem dieses Stundenkonto gehört.
Name
balance
Type
number
Description
Zwischengespeicherter Überstundensaldo zum Stand der Berechnung des Vortages.
Name
calculated_at
Type
string (date-time)
Description
Zeitstempel, zu dem der Saldo zuletzt berechnet wurde.
Name
vacation
Type
Liste von object
Description
Genehmigte, geplante, verbleibende und jährliche Urlaubsansprüche in Tagen, pro Zeitraum.
Name
vacation.year
Type
string
Description
Das Kalenderjahr, auf das sich dieser Anspruchszeitraum bezieht.
Name
vacation.approved
Type
number
Description
In diesem Zeitraum bereits genehmigte Urlaubstage.
Name
vacation.planned
Type
number
Description
In diesem Zeitraum geplante, aber noch nicht genehmigte Urlaubstage.
Name
vacation.remaining
Type
number
Description
In diesem Zeitraum noch verfügbare Urlaubstage.
Name
vacation.annual_entitlement
Type
number
Description
Der volle jährliche Urlaubsanspruch für diesen Zeitraum, in Tagen.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

GET Stundenkonten auflisten Kunden