v1
latestOpenAPI 3.1.02026-07-14801408.6 KB/time-tracking/time-entries
Returns a paginated list of time entries. Required scope: r_time_tracking. Supports both user and account tokens.
Account token — when employee_ids is omitted, returns all entries in the account.
User token — when employee_ids is omitted, returns the user's own entries plus all direct and indirect descendants' entries. A user with the time tracking manage permission receives all account entries.
Query parameters
Filter by entry type(s). Valid values: time-entry, clock-in, clock-out, ergani-clock-in, ergani-clock-out
ISO 8601 date — return entries at or after this date
ISO 8601 date — return entries at or before this date
Filter by one or more employee SPI keys. Available to both account and user tokens. User tokens are authorized per employee and receive a 403 if any id cannot be viewed.
Filter by worked minutes, used together with duration_operator
Comparison operator for duration. One of: equal, greater_than, greater_than_or_equal, less_than, less_than_or_equal
Number of results per page. Allowed values: 10, 20, 50, 100
Number of entries to skip (for pagination)
Response
200
Example response
{
"total_count": 2,
"time_entries": [
{
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"employee_id": "3fc9a811",
"type": "time-entry",
"clock_in_time": "2024-01-15T09:00:00.000Z",
"clock_out_time": "2024-01-15T17:30:00.000Z",
"worked_minutes": 510,
"note": "Regular shift",
"timezone": "Europe/London"
}
]
}