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

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 ISO week

​
filters
object

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

​
buckets
object[]