Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-08-06130577659.7 KB
Time Tracking|Employee time tracking

Fetch employee time tracking.

This endpoint allows you to retrieve an employee's timesheet using the employeeReference and a timeframe from which to retrieve the timesheet. The time sheet will provide an overview of the worktime within the timeframe or detailed information on the worktime for each day within the specified timeframe. Additionally, the employee timesheet provides comprehensive details, including 'overtime', 'drive duration' or 'drive distance', if applicable. Drive data on the timesheet is accessible if the employee is registered as a driver for a vehicle. Vehicles may have fixed or variable drivers, depending on the stamps created in the vehicle. In addition, you will receive information regarding the balance of the employee's time account. All time durations are provided in seconds.

get/employee_time_tracking/fetch

Query parameters

employeeReferencestring

The personnel number of the employee. The employeeReference or importKey is required.

importKeystring

The external id of the employee. The employeeReference or importKey is required.

fromstring required
Example:2022-12-22

Start date.

tostring required
Example:2022-12-22

End date

Response

Success Response:

timeAccountBalanceinteger

The time account at the time of the last monthly closing before the end date.

vacationBalanceinteger

The vacation balance at the time of the last monthly closing before the end date.

accountBalanceDatestring

Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd

lastAccountBalanceDatestring

Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd

Example response

{
  "timeSheet": {
    "from": "2015-02-20",
    "to": "2015-02-20",
    "days": [
      {
        "date": "2015-02-20",
        "timeRecords": [
          {
            "date": "2015-02-20",
            "startTime": "2015-02-20T12:59:21+01:00",
            "endTime": "2015-02-20T12:59:21+01:00",
            "project": {
              "latLng": [
                52.38127828631681,
                7.594243214018696
              ]
            }
          }
        ],
        "driveClassifications": [
          {
            "drives": [
              {
                "startTime": "2015-02-20T12:59:21+01:00",
                "endTime": "2015-02-20T12:59:21+01:00"
              }
            ]
          }
        ],
        "accountingEntries": [
          {
            "date": "2015-02-20",
            "project": {
              "latLng": [
                52.38127828631681,
                7.594243214018696
              ]
            }
          }
        ],
        "shiftStart": "2015-02-20T12:59:21+01:00",
        "shiftEnd": "2015-02-20T12:59:21+01:00"
      }
    ]
  },
  "accountBalanceDate": "2015-02-20",
  "lastAccountBalanceDate": "2015-02-20"
}