---
title: "Get Team Timesheets"
method: GET
path: "/timesheets"
tags: ["Timesheets"]
---

# Get Team Timesheets

`GET /timesheets`

List timesheet weeks across the team, grouped by user.

## Query parameters

- `weekId` number
- `limit` integer

## Response `200`

OK

- Timesheet[]
  - `id` number — Timesheet ID
  - `week` Week
    - `id` number
    - `from` string
    - `to` string
    - `beginningOfWeek` number — 0 if Sunday, 1 if Monday
  - `user` number — User ID
  - `tasks` Task[] — List of tasks added in the timesheet
    - `id` string, required
    - `name` string, required
    - `projects` string[], required — List of projects ID
    - `section` number, nullable — Section ID
    - `labels` string[]
    - `position` number
    - `description` string, nullable
    - `dueAt` string, nullable — Format: Y-m-d H:i:s
    - `status` 'open' | 'closed'
    - `time` TaskTime
      - `total` number, required — Total task time in seconds
      - `users` object, required — Task time per user ID
    - `estimate` TaskEstimate
      - `total` number, required — Total task estimate in seconds
      - `type` 'overall' | 'users', required
      - `users` object — Task estimate per user ID
    - `attributes` object — Custom attributes from integration
    - `metrics` object — Custom metrics from integration
    - `unbillable` boolean
  - `dailyTime` DailyTime[] — Daily time
    - `date` string
    - `time` number — Total daily time in seconds
    - `timeWithoutTask` number — Time tracked without task
    - `user` number — User ID
  - `taskTime` TaskTime[] — List of task time records
    - `total` number, required — Total task time in seconds
    - `users` object, required — Task time per user ID
  - `approval` TimesheetApproval
    - `id` number — Timesheet ID
    - `user` number — User ID
    - `weekId` number
    - `reviewer` number — Reviewer User ID
    - `history` TimesheetApprovalHistory[]
      - `action` 'submitted' | 'rejected' | 'approved' | 'discarded'
      - `days` ApprovalHistoryDays
        - `monday` boolean
        - `tuesday` boolean
        - `wednesday` boolean
        - `thursday` boolean
        - `friday` boolean
        - `saturday` boolean
        - `sunday` boolean
      - `user` number — User ID
      - `comment` string
      - `createdAt` string — Datetime when action was created
    - `status` 'pending' | 'rejected' | 'approved' | 'partial_approved' | 'discarded'
    - `totalTime` integer, nullable — Total approved time in seconds.
  - `timecards` Timecard[]
    - `user` number, required — User ID
    - `clockIn` string — Clock-in time in user timezone
    - `clockOut` string — Clock-out time in user timezone
    - `breakTime` number — Breaks duration in seconds
    - `workTime` number, required — Working time in seconds
    - `history` TimecardHistory[]
      - `action` 'clock-in' | 'clock-out' | 'break' — What data are changed
      - `previousTime` string — Old value for clockIn, clockOut or break
      - `time` string — New value for clockIn, clockOut or break
      - `trigger` 'manually' | 'timer' | 'button' | 'day-end' | 'idle-state' — Action trigger
    - `date` string — Format: Y-m-d
    - `weekId` integer — Week identifier (YYWW).
    - `isLocked` boolean
    - `invalid` object, nullable — Validation issues for the timecard, if any.
    - `lockReasons` string[]
  - `timeOffAssignments` TimeOff[]
    - `days` number — Number of workdays
    - `endDate` string
    - `id` number
    - `startDate` string
    - `type` string
    - `user` number
    - `timeOffPeriod` 'full-day' | 'half-of-day' | 'quarter-of-day' | 'half-and-quarter-of-day'
    - `reviewer` number — Admin who must receive notification for approval
    - `attachments` AttachmentDetails[]
      - `id` number
      - `name` string
      - `token` string

## Other responses

- `401` — Unauthorized

---

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