List or aggregate time entries

Returns a date-bounded paginated list using the same composable filters as reports and CSV. Values within a dimension are ORed; dimensions are ANDed. Aggregation is served by GET /{team_id}/time/reports.

During the rolling migration, the legacy scope_type, scope_id, user_id, aggregate, and group_by parameters remain supported. New clients should use the canonical filters and report endpoint.

GET /{team_id}/time/entries

List or aggregate time entries

cURL

curl --request GET \
  --url https://api.superthread.com/v1/{team_id}/time/entries \
  --header 'Authorization: Bearer <token>'

200

{
  "cursor": "dmsjqh9d8w1hdjosjaasda",
  "count": 14,
  "time_entries": [
    {
      "id": "01HQK6Z9YJZ4M9JX8FVB6QXYAB",
      "team_id": "tDsu0j19",
      "card_id": "2700",
      "user_id": "uR2dws11",
      "started_at": 1608742037016,
      "duration_seconds": 1800,
      "billable": true,
      "rate_snapshot_cents": 12500,
      "currency_snapshot": "GBP",
      "source": "manual",
      "version": 1,
      "type": "time_entry",
      "scope_type": "card",
      "scope_id": "<string>",
      "card_title_snapshot": "Prepare September campaign",
      "space_id_snapshot": "space_01HQK6Z9YJZ4M9JX8FVB6QXYAB",
      "project_id_snapshot": "2701",
      "board_id_snapshot": "board_01HQK6Z9YJZ4M9JX8FVB6QXYAB",
      "sprint_id_snapshot": "sprint_01HQK6Z9YJZ4M9JX8FVB6QXYAB",
      "ancestor_card_ids_snapshot": [
        "<string>"
      ],
      "time_category_id": "tc_01HQK6Z9YJZ4M9JX8FVB6QXYAB",
      "category_id": "<string>",
      "description": "Pairing with Alex on the API spec",
      "needs_review": true,
      "review_reason": "abandoned_timer",
      "reviewed_at": 1608742037016,
      "reviewed_by": "<string>",
      "deleted_at": 1608742037016,
      "locked_at": 1608742037016,
      "time_created": 1608742037016,
      "time_updated": 1608742037016
    }
  ],
  "filters": {
    "from": 123,
    "to": 123,
    "timezone": "Europe/London",
    "logger_ids": [
      "<string>"
    ],
    "assignee_ids": [
      "<string>"
    ],
    "space_ids": [
      "<string>"
    ],
    "project_ids": [
      "<string>"
    ],
    "board_ids": [
      "<string>"
    ],
    "sprint_ids": [
      "<string>"
    ],
    "card_ids": [
      "<string>"
    ],
    "category_ids": [
      "<string>"
    ],
    "tag_ids": [
      "<string>"
    ],
    "tag_match": "any",
    "billable": true,
    "sources": [
      "manual"
    ],
    "rollup_mode": "direct"
  },
  "group_by": "user",
  "buckets": [
    {
      "user_id": "<string>",
      "scope_type": "card",
      "scope_id": "<string>",
      "week_start": 1608742037016,
      "billable": true,
      "total_seconds": 123,
      "total_cents": 123,
      "entry_count": 123
    }
  ]
}

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>

Lower bound (inclusive), as a Unix timestamp in seconds. Required for canonical queries.

to · integer<int64>

Upper bound (exclusive), as a Unix timestamp in seconds. Required for canonical queries.

scope_type · enum<string>

Legacy filter for a card scope.

Available options: card, category

scope_id · string

Legacy scope ID filter, used with scope_type.

user_id · string

Legacy single logger filter.

aggregate · boolean

Legacy aggregate mode. New clients should use /time/reports.

group_by · enum<string>

Legacy aggregate dimension. Required when aggregate=true.

Available options: user, scope, week, billable

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

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

200

application/json

Paginated list of time entries matching the canonical filters.

cursor · string · required

Example:

"dmsjqh9d8w1hdjosjaasda"

count · integer · required

Example:

14

time_entries · object[]

Show child attributes

filters · object

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

Show child attributes

group_by · enum<string>

Available options: user, scope, week, billable

buckets · object[]

Show child attributes