v2

latestOpenAPI 3.0.12026-07-31690160432.4 KB

Task Timer

Get global timesheet report

Fetches a paginated global timesheet report grouped by PROJECT or MEMBER. Returns hierarchical data: when grouped by PROJECT -> members -> tasks; when grouped by MEMBER -> projects -> tasks. Includes billable/non-billable time, total time, and billable cost for each level.

get/v1/time-track/reports/global

Query parameters

groupBy'PROJECT' | 'MEMBER'

Group results by PROJECT or MEMBER

startDatestring date required

Example:2025-01-01

Start date filter (ISO format: yyyy-MM-dd)

endDatestring date required

Example:2025-12-31

End date filter (ISO format: yyyy-MM-dd)

pageinteger

Page number (zero-based)

sizeinteger

Page size

searchCriteriastring

JSON filter criteria. Supported fields: member, project, space, customer, status (IS/ISNOT with id list); billable (IS/ISNOT with boolean value, e.g. true for billable only, false for non-billable only); timeMode (selects which timestamp the date range and ordering target — allowed values: STARTED_TIME (default) or CREATED_TIME). Example: {"filters":[{"field":"member","condition":"IS","value":[1,2]},{"field":"billable","condition":"IS","value":true},{"field":"timeMode","value":"CREATED_TIME"}],"operator":"AND"}

sortProperty'startedTime' | 'createdTime'

Column to sort task rows by. Defaults to the legacy most-recently-active ordering when omitted.

sortDirection'asc' | 'desc'

Sort direction; only honoured when sortProperty is provided.

Headers

X-Org-Idinteger required

Example:1

Organization ID (in header)

Response

Global timesheet report fetched successfully

successboolean

Indicates if the operation was successful

messagestring

Message describing the result of the operation

codeinteger

HTTP status code of the response

timestampstring date-time

Timestamp of the response