Get workhour balance and vacation entitlement details

You can use this endpoint to retrieve a single workhour balance record by its numeric id.

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}'

Response

{
  "data": {
    "id": 1,
    "employee_id": "jdoe",
    "balance": 12.75,
    "calculated_at": "2026-06-21T23:59:59+02:00",
    "vacation": [
      {
        "year": 2026,
        "approved": 8.0,
        "planned": 2.0,
        "remaining": 20.0,
        "annual_entitlement": 30.0
      }
    ]
  }
}

Path parameters

Name
id
Type
integer
Description
The workhour balance record ID

List workhour balances and vacation entitlements Customers