RyTask docs
REST APITime reports

Report: where did the time go? (in progress)

**Status: in progress — ships in the next release.** The flagship report: totals, weekly planned-vs-interruption breakdown, and the top items by logged time for an inclusive date range (366 days max). Requires `work:read`; with `projectId` the caller must be able to view that project.

View as MarkdownOpen in ChatGPTOpen in Claude
GET
/time/reports/overview

Status: in progress — ships in the next release. The flagship report: totals, weekly planned-vs-interruption breakdown, and the top items by logged time for an inclusive date range (366 days max). Requires work:read; with projectId the caller must be able to view that project.

Authorization

bearerAuth
AuthorizationBearer <token>

A session access token or a personal access token.

In: header

Query Parameters

from*string

First day of the range (inclusive, UTC).

to*string

Last day of the range (inclusive, UTC). At most 366 days after from.

projectId?string
userId?string

Response Body

application/json

curl -X GET "https://example.com/time/reports/overview?from=2019-08-24&to=2019-08-24"
{  "data": {    "range": {      "from": "2019-08-24",      "to": "2019-08-24"    },    "totals": {      "loggedSeconds": 0,      "plannedSeconds": 0,      "interruptionSeconds": 0    },    "weeks": [      {        "weekStart": "2019-08-24",        "loggedSeconds": 0,        "plannedSeconds": 0,        "interruptionSeconds": 0      }    ],    "topItems": [      {        "workItemId": "1769c5a2-ca6e-4792-8bf1-b1a261dc7481",        "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",        "key": "string",        "title": "string",        "loggedSeconds": 0      }    ]  }}
Empty
Empty
Empty