---
title: "Time Tracking Report"
method: GET
path: "/api/reports/time-tracking"
tags: ["reports"]
---

# Time Tracking Report

`GET /api/reports/time-tracking`

## Request

- Base URL: `https://app.ctlsurf.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ctlsurf.com/api/reports/time-tracking`
- Auth: HTTP bearer

Aggregate active time across each project's 'Time Tracking' datastore.

Rows are read from `datastore_rows` belonging to a `datastore` block titled
'Time Tracking' on an 'Agent Datastore' dataspace page in a non-archived
folder owned by the requesting user.

## Query parameters

- `start` string, date-time, nullable: Inclusive lower bound on row created_at
- `end` string, date-time, nullable: Exclusive upper bound on row created_at
- `folder_id` string[], nullable: Filter by one or more folder ids
- `group_by` string
- `tz` string: IANA timezone for day bucketing (e.g. 'America/Los_Angeles'). Defaults to UTC.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ctlsurf/apis/notebook-control-plane.md) · [All operations](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/ctlsurf/apis/notebook-control-plane/revisions/ddfbbe20d5ce?raw)