--- title: "Fetch employee time tracking." method: GET path: "/employee_time_tracking/fetch" tags: ["Time Tracking|Employee time tracking"] --- # Fetch employee time tracking. `GET /employee_time_tracking/fetch` 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. ## Query parameters - `employeeReference` string - `importKey` string - `from` string, required - `to` string, required ## Response `200` Success Response: - StandardEmployeeTimeTrackingFetchResponse - `timeSheet` EmployeeTimeTrackingFetchResponseEmployeeTimeSheetItem - `employee` EmployeeTimeTrackingFetchResponseEmployeeItem - `id` integer — The internal employee ID. - `reference` string — The personal number. (max. 20 characters) - `cardNumber` string — The driver card number. - `importSource` string — External data source from which this employee originates. (max. 16 characters) - `importKey` string — External ID from the respective data source. (max. 64 characters) - `firstName` string — The first name of the employee. (max. 128 characters) - `lastName` string — The last name of the Employee. (max. 128 characters) - `name` string — This field is deprecated. Please use firstName The complete Name of the Employee If first name or last name is set, name is ignored. - `from` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `to` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `days` object[] — Days of the time sheet. - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `timeRecords` object[] - `id` integer — The internal time record ID. - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `type` string — The type of the time record. | Value | Description | | ------------------------- | ------------------------------------- | | WORK | Work | | BREAK | Break | - `salaryType` string — The salarytype of the time record. - `startTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `endTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `worktime` integer — The work time of the time record. - `breakDuration` integer — The break time of the time record. - `project` EmployeeTimeTrackingFetchResponseProjectItem - `id` integer — The internal project ID. - `reference` string — The project number. - `importSource` string — External data source from which this project originated. - `importKey` string — External ID from the respective data source. - `name` string — The project name. (max. 255 characters) - `description` string — The project description. - `extraName1` string — The name1 address addition. (max. 255 characters) - `extraName2` string — The name2 address addition. (max. 255 characters) - `extraName3` string — The name3 address addition. (max. 255 characters) - `street` string — The street. - `zipCode` string — The zip code. - `city` string — The city. - `countryCode` string — The two-digit ISO 3166 country code. - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `costCenter` string — The cost center. (max. 64 characters) - `isApproved` boolean — Shows if the time pair is approved. - `driveClassifications` object[] - `driveType` string — The Drive Type. Classifies the type of drive activity: - ARRIVAL: Drive to the work location - DEPARTURE: Drive away from the work location - MOVE: Drive between locations during working hours - `distance` integer — The driving distance. Total distance traveled in meters. - `worktime` integer — The working time in hours. Time spent driving that counts towards working hours. - `totalWorktime` integer — The total working time in hours. Aggregate of all working time for this drive classification. - `drives` object[] — All drive records associated with this classification. Collection of individual drive instances that belong to this classification. - `startTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `endTime` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `distanceDriver` integer — The distance traveled as driver in meters. Total distance covered while actively driving the vehicle. - `durationDriver` integer — The duration as driver in seconds. Total time spent actively driving the vehicle. - `durationWithinWorktimeDriver` integer — The duration as driver within worktime in seconds. Time spent driving that counts towards paid working hours. - `distancePassenger` integer — The distance traveled as passenger in meters. Total distance covered while traveling as a passenger. - `durationPassenger` integer — The duration as passenger in seconds. Total time spent as a passenger during the drive. - `durationWithinWorktimePassenger` integer — The duration as passenger within worktime in seconds. Time spent as a passenger that counts towards paid working hours. - `licenseNumber` string — The license plate of the vehicle. - `projectReferenceSign` string — The reference sign of the project. - `durationPassenger` integer — The duration as passenger in seconds. Total time spent as a passenger during drives. - `durationDriver` integer — The duration as driver in seconds. Total time spent actively driving the vehicle. - `totalDuration` integer — The total duration of all drives in seconds. Sum of all drive durations including both driver and passenger time. - `worktimeBySalaryType` integer[] — The working time broken down by salary type for each drive. - `totalWorktimeBySalaryType` integer[] — The total working time aggregated by salary type. - `totalSetupTimeBySalaryType` integer[] — The total setup time aggregated by salary type. - `totalSetupTimeBySalaryTypeAndCostCenter` integer[] — The total setup time aggregated by salary type and cost center. - `setupTimeDuration` integer — The total setup time duration in seconds. - `totalSetupTimeWorktime` integer — The total setup time working hours. - `absences` object[] - `id` integer — The internal ID. - `importSource` string — External data source from which this absence originates. (max. 20 characters) - `importKey` string — External ID of the respective data source. (max. 64 characters) - `name` string — The name of the absence. - `salaryType` string — The salary type of the absence. - `duration` integer — The salary type of the absence. - `worktime` integer — The salary type of the absence. - `accountingEntries` object[] - `id` integer — The internal accounting entry ID. - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `description` string — The description of the accounting entry. - `salaryType` string — The salary type of the accounting entry. - `value` number — The value of the accounting entry. - `valueUnit` string — The value unit of the accounting entry. | Value | Description | | ------------------------- | -------------------------------------- | | HOUR | Hours | | DAY | Days | | CURRENCY | Currency | | QUANTITY | Quantity | - `project` EmployeeTimeTrackingFetchResponseProjectItem - `id` integer — The internal project ID. - `reference` string — The project number. - `importSource` string — External data source from which this project originated. - `importKey` string — External ID from the respective data source. - `name` string — The project name. (max. 255 characters) - `description` string — The project description. - `extraName1` string — The name1 address addition. (max. 255 characters) - `extraName2` string — The name2 address addition. (max. 255 characters) - `extraName3` string — The name3 address addition. (max. 255 characters) - `street` string — The street. - `zipCode` string — The zip code. - `city` string — The city. - `countryCode` string — The two-digit ISO 3166 country code. - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `costCenter` string — The cost center. (max. 64 characters) - `costCenter` string — The cost center of the accounting entry. - `isHoliday` boolean — Holiday - `shiftStart` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `shiftEnd` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `targetWorktime` integer — Target worktime - `worktime` integer — Worktime - `paidWorktime` integer — Paid worktime - `actualWorktime` integer — Rounded worktime without absences, holidays and accounting entries. - `absentWorktime` integer — The worktime created by absences. - `absentPaidWorktime` integer — The paid worktime created by absences. - `accountingWorktime` integer — The worktime created by accounting entries. - `accountingPaidWorktime` integer — The paid worktime created by accounting entries. - `holidayWorktime` integer — The worktime created by holidays. - `stampedWorktime` integer — The worktime created by time stamping. - `breakDuration` integer — The break time. - `driveWorktime` integer — The worktime created by driving rules. - `driveDuration` integer — The drive time determined by driving rules. - `driveDistance` integer — The drive distance determined by driving rules. - `setupTimeWorktime` integer — The worktime within the set-up time. - `setupTimeDuration` integer — The set-up time. - `overtime` integer — The overtime. - `roundingDifference` integer — The time difference after the overtime rounding. - `targetWorktime` integer — Target worktime. - `worktime` integer — Worktime. - `paidWorktime` integer — Paid worktime. - `actualWorktime` integer — The rounded worktime without absences, holidays and accounting entries. - `absentWorktime` integer — The worktime created by absences. - `absentPaidWorktime` integer — The paid worktime created by absences. - `accountingWorktime` integer — The worktime created by accounting entries. - `accountingPaidWorktime` integer — The paid worktime created by accounting entries. - `holidayWorktime` integer — The worktime created by holidays. - `stampedWorktime` integer — The worktime created by time stamping. - `breakDuration` integer — The break time. - `driveWorktime` integer — The worktime created by driving rules. - `driveDuration` integer — The drive time determined by driving rules. - `driveDistance` integer — The drive distance determined by driving rules. - `setupTimeWorktime` integer — The worktime within the set-up time. - `setupTimeDuration` integer — The set-up time. - `overtime` integer — The overtime. - `roundingDifference` integer — The time difference after the overtime rounding. - `subtractedOvertime` integer — The subtracted time due to the agreed overtime. This value is filled only when a full month is evaluated. - `timeAccountBalance` integer — The time account at the time of the last monthly closing before the end date. - `vacationBalance` integer — The vacation balance at the time of the last monthly closing before the end date. - `accountBalanceDate` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `lastAccountBalanceDate` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd --- [API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/15839b24c497/schema)