Skip to main content
GET
/
{team_id}
/
time
/
reports
/
category
Time report grouped by category
curl --request GET \
  --url https://api.superthread.com/v1/{team_id}/time/reports/category \
  --header 'Authorization: Bearer <token>'
{
  "filters": {
    "from": 1735689600,
    "to": 1738368000,
    "billable": true,
    "user_ids": [
      "<string>"
    ],
    "project_ids": [
      "<string>"
    ],
    "category_ids": [
      "<string>"
    ]
  },
  "buckets": [
    {
      "time_category_id": "tc_01HQK6Z9YJZ4M9JX8FVB6QXYAB",
      "total_seconds": 14400,
      "total_cents": 50000,
      "entry_count": 12
    }
  ]
}

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.

​
billable
boolean

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

​
user_ids
string[]

Optional filter — restrict to entries from these user IDs.

​
project_ids
string[]

Optional filter — restrict to entries logged on cards within these project IDs.

​
category_ids
string[]

Optional filter — restrict to entries logged against these time category IDs.

​
format
enum<string>

Response format. json (default) returns the JSON envelope. csv returns a flat CSV export with one row per bucket (text/csv content-type).

Available options:
json,
csv

Response

Aggregated time totals by category

​
filters
object

Echo of the filters that were applied to produce this report.

​
buckets
object[]