Skip to main content
GET
Query time reports

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id
string
required

Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".

Query Parameters

from
integer<int64>
required

Lower bound (inclusive) for the report window, as a Unix timestamp in seconds.

to
integer<int64>
required

Upper bound (exclusive) for the report window, as a Unix timestamp in seconds.

timezone
string

IANA timezone used for day, week, and month boundaries.

logger_ids
string[]

Restrict to entries logged by these member IDs.

assignee_ids
string[]

Restrict to cards currently assigned to any of these member IDs.

space_ids
string[]

Restrict to entries whose card was in these spaces when the time was logged.

project_ids
string[]

Restrict to entries on cards currently in these projects, including time logged before the cards joined.

board_ids
string[]

Restrict to entries whose card was in these boards when the time was logged.

sprint_ids
string[]

Restrict to entries whose card was in these sprints when the time was logged.

card_ids
string[]

Restrict to these cards. Descendant roll-up uses the ancestor path captured when each entry was logged.

category_ids
string[]

Restrict to entries assigned to these time categories.

tag_ids
string[]

Restrict to cards currently carrying the selected tags.

tag_match
enum<string>

Match cards carrying any selected tag or every selected tag.

Available options:
any,
all
billable
boolean

Optional filter — restrict to billable (true) or non-billable (false) entries.

sources
enum<string>[]

Restrict to entries created manually, by a timer, or by idle-time handling.

Available options:
manual,
timer,
idle
rollup_mode
enum<string>

Direct includes only cards in the selected scope; descendants recursively includes every child card.

Available options:
direct,
descendants
group_by
enum<string>

Independent report grouping dimension.

Available options:
member,
day,
week,
month,
space,
project,
board,
sprint,
card,
category,
tag,
billable
cursor
string

Opaque cursor for date-bounded time-entry or report pagination.

limit
integer

Page size. The service applies a bounded default and maximum.

Required range: 1 <= x <= 500

Response

Paginated report buckets and authoritative totals.

cursor
string
required
Example:

"dmsjqh9d8w1hdjosjaasda"

count
integer
required
Example:

14

filters
object

Exact effective filters applied by entries, reports, and CSV.

group_by
enum<string>

Independent grouping dimension for a time report.

Available options:
member,
day,
week,
month,
space,
project,
board,
sprint,
card,
category,
tag,
billable
Example:

"member"

totals
object

Authoritative totals for a set of deduplicated cards and entries.

buckets
object[]