Skip to main content
Retrieve the authenticated employee’s timesheet — their time entries for a date range, plus computed totals, current pay period, and clock status.
Authentication: requires an employee JWT (Authorization: Bearer <token>). The employee is identified from the token’s userId — there is no employee-id path/query parameter.

Query parameters

string
ISO date string. Defaults to the start of the current week (Sunday, 00:00:00) if omitted.
string
ISO date string. Defaults to the end of the current week (Saturday, 23:59:59) if omitted.
string
Optional. Filter entries to a single pay period.
Returns 400 Invalid date format for unparseable dates, or 400 Invalid date range if startDate is after endDate. Time entries are matched on clockIn falling within the range.

Response

object
id, firstName, lastName, employeeNumber, jobTitle, payRate, payType.
object
The employee’s company, including payPeriodType and the bookkeeper org’s overtimeThreshold, overtimeMultiplier, and timezone.
array
Time entries within the range (newest first). Each entry includes its payPeriod summary (id, startDate, endDate, status, locked).
object | null
The pay period covering “now” for this company, or null if none.
object
totalHours, regularHours, overtimeHours, pendingEntries (count with status PENDING), approvedEntries (count where approved is true).
object
isClockedIn (boolean) and openTimeEntry ({ id, clockIn } or null).
object
The resolved startDate and endDate used for the query.

Examples

Returns 401 if the token is missing/invalid, 404 Employee not found if the token’s user no longer exists.