---
title: "Get Timelogs (Task)"
method: GET
path: "/tasks/{taskId}/timelogs"
tags: ["Timelogs"]
---

# Get Timelogs (Task)

`GET /tasks/{taskId}/timelogs`

Get all timelog records for a task.

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

## Path parameters

- `taskId` string, required

## Query parameters

- `me` boolean — If present - only timelogs created by current user are returned
- `descendants` boolean — Adds all descendant tasks to search scope
- `plainText` boolean — Get comment text as plain text, HTML otherwise
- `limit` number — Limit on number of returned timelogs
- `pageSize` number — Page size for pagination (1-1000 items per page). When not specified, all matching timelogs are returned in a single response. When specified, results are paginated and nextPageToken is provided for subsequent pages.
- `nextPageToken` string — A pagination request will return a token that applies an offset to the next page. The returned value should be used as an input parameter in the next request. Parameter pageSize can be omitted in this case.

## Response `2XX`

success response

- object
  - `data` Timelog[]
    - `approvalStatus` 'NotSubmitted' | 'Approved' | 'Rejected' | 'Pending' — * `NotSubmitted` * `Approved` * `Rejected` * `Pending`
    - `hours` number — Hours tracked in timelog record, must be in [0..24] hours range
    - `exportStatus` 'NotExported' | 'Exported' | 'ReadyForExport' — * `NotExported` - Not Exported * `Exported` - Exported * `ReadyForExport` - Ready For Export
    - `updatedDate` string — Date of timelog was updated<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
    - `userId` string
    - `createdDate` string — Date of timelog was created<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
    - `lockStatus` 'Locked' | 'Unlocked' — * `Locked` - Locked * `Unlocked` - Unlocked
    - `billingType` 'Billable' | 'NonBillable' — * `Billable` - Billable * `NonBillable` - Non-Billable
    - `trackedDate` string — Date for which timelog was recorded<br>Format: yyyy-MM-dd
    - `comment` string — Timelog record comment
    - `id` string
    - `taskId` string
    - `categoryId` string
    - `finance` TimelogFinance
      - `currency` string — Currency
      - `actualFees` number — Actual fees
      - `actualCost` number — Actual cost
  - `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)