---
title: "Returns all time reports of a user."
method: GET
path: "/timereports"
tags: ["timeReports"]
---

# Returns all time reports of a user.

`GET /timereports`

Returns time reports the user created as well as the shared time reports of
            other users.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

## Headers

- `Authorization` string, required

## Response `200`

OK

- TimeReport[]
  - `shared` boolean — Whether the time report is shared.
  - `dateMode` string, nullable — The date mode of the time report. Can be: "today", "yesterday", "selectDate", "selectWeek", "currentWeek", "lastWeek", "selectMonth", "currentMonth", "lastMonth", "selectQuarter", "currentQuarter", "lastQuarter", "selectYear", "currentYear", "lastYear", "customRange", "noFilter".
  - `startOn` string, date-time, nullable — The start date time of the report when DateMode is "customRange".
  - `endOn` string, date-time, nullable — The end date time of the time report. when DateMode is "customRange". Currently the start of the end day.
  - `filter` string, nullable — The generated filter query of the time report.
  - `chartType` string, nullable — The actual chart type of the time report. Can be: "group" or "time".
  - `projectId` string, uuid, nullable — The id of the project of the time report. Used for the pdf reports.
  - `companyId` string, uuid, nullable — The id of the company of the time report. Used for the pdf reports.
  - `sumBy` string, nullable — Summarises the values by the sum of this property.
  - `sortBy` string, nullable — Sorts the values by this property.
  - `sortByOrder` string, nullable — The way how to sort the data. Can be: "asc", desc".
  - `roundBy` string, nullable — Rounding method of the time report. Can be: "nearQuarter", "nearHalf", "nearHour", "upQuarter", "upHalf", "upHour".
  - `groupBy` string, nullable — Group the values by property.
  - `sortColumn` string, nullable — Sort the values of the time report by a column.
  - `sortGroupsEnabled` boolean, nullable — Whether sorting of groups is enabled.
  - `availableColumns` string[], nullable — List of shown Columns in the time report. Can be: "status", "duration", "task", "timeTrackingNote", "typeOfWork", "project", "date", "time", "user", "client", "projectType", "projectRole", "plannedDuration", "taskList", "key".
  - `billingStatuses` string[], nullable — Filter of bill satuses of the time report. Can be: "billed", "notBilled", "notBillable".
  - `note` string, nullable — Filter time entries by note.
  - `usersFilter` string[], nullable — Filter time entries by users.
  - `projectsFilter` string[], nullable — Filter time entries by projects.
  - `noProjectFilter` boolean, nullable — Filter to show also time entries without a project.
  - `projectCompaniesFilter` string[], nullable — Filter time entries by projects of the companies.
  - `projectTypesFilter` string[], nullable — Filter time entries by projects of the type.
  - `projectStatusesNameFilter` string[], nullable — Filter time entries by projects with status name.
  - `projectStatusTypesFilter` string[], nullable — Filter time entries by projects with status of type.
  - `projectTeamsFilter` string[], nullable — List of teams, to the filter the projects for.
  - `userTeamsFilter` string[], nullable — Filter for the teams to filter the users.
  - `taskTagsModelFilter` DefaultTagModel[], nullable — Filter time entries by the tags of the task.
    - `id` string, uuid — The Id of the tag.
    - `name` string, nullable — The name of the tag.
    - `color` string, nullable — The color of the tag.
    - `entityId` string, uuid — The id of the entity the tag is related to.
  - `projectTagsModelFilter` DefaultTagModel[], nullable — Filter time entries by the tags of the project.
    - `id` string, uuid — The Id of the tag.
    - `name` string, nullable — The name of the tag.
    - `color` string, nullable — The color of the tag.
    - `entityId` string, uuid — The id of the entity the tag is related to.
  - `userTagsModelFilter` DefaultTagModel[], nullable — Filter time entries by the tags of the users.
    - `id` string, uuid — The Id of the tag.
    - `name` string, nullable — The name of the tag.
    - `color` string, nullable — The color of the tag.
    - `entityId` string, uuid — The id of the entity the tag is related to.
  - `typesOfWorkFilter` string[], nullable — Group the time report by the type of works.
  - `name` string, nullable — The name of the time report.
  - `id` string, uuid — The id of the time report.
  - `user` NestedUserModel
    - `id` string, uuid — Gets or sets the id of the nested model.
    - `firstName` string, nullable — The first name of the user.
    - `lastName` string, nullable — The last name of the user.
    - `hasImage` boolean, nullable — Whether this user has a profile image.
  - `updatedOn` string, date-time — The date this time report was updated.
  - `resourceVersion` integer — The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)