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

# Query Timesheets

`GET /timesheets`

Retrieves user timesheets.Note: Only timesheets that have been explicitly created—either via the UI or API—will be returned. Unsubmitted timesheets that have never been accessed do not exist in the database and cannot be retrieved. There is no endpoint to query for timesheets that have not yet been created.

<b>Scopes:</b> Default, wsReadOnly, wsReadWrite

## Response `2XX`

success response

- object
  - `data` Timesheet[]
    - `timesheetId` string
    - `accountId` string
    - `periodStartDate` string — Date of when the timesheet started<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
    - `timeframe` 'Monthly' | 'Weekly' — * `Monthly` * `Weekly`
    - `approval` TimesheetApproval
      - `approvalStatus` 'NotSubmitted' | 'Approved' | 'Rejected' | 'Pending', required — * `NotSubmitted` * `Approved` * `Rejected` * `Pending`
      - `approvalChangeDate` string, required — Date of when the timesheet was approved or rejected<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
      - `submitterId` string, required — User ID of the person who submitted the timesheet
      - `approverId` string, required — User ID of the approver
      - `submissionChangeDate` string, required — Date of when the timesheet was submitted<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
    - `rows` TimesheetRow[] — List of timesheet rows
      - `parentIds` FolderId[], required — List of entry parent folder IDs
      - `type` string, required
      - `weeklyEntries` TimesheetRowWeeklyEntry[], required — List of weekly entries per row
        - `date` string, required — Date of the entry <br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
        - `entriesIds` TimelogId[], required — List of time entry IDs
        - `sum` number, required — Sum of hours logged for this date
      - `taskId` string, required — Task ID associated with this row
      - `categoryId` string, required
      - `rowId` string, required
    - `userId` string
    - `periodEndDate` string — Date of when the timesheet ended<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
  - `kind` 'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'userAggregatedCapacity' | 'cascadingFieldSettings'

## Other responses

- `4XX` — client-side error response
- `5XX` — server-side error response

---

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