> ## Documentation Index
> Fetch the complete documentation index at: https://developers.wrike.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Timelogs (Account)
Get all timelog records in current account.
Scopes: Default, wsReadOnly, wsReadWrite
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Wrike API",
"version": "4.0"
},
"servers": [
{
"url": "https://www.wrike.com/api/v4"
},
{
"url": "https://app-eu.wrike.com/api/v4"
},
{
"url": "https://app-us2.wrike.com/api/v4"
}
],
"paths": {
"/timelogs": {
"get": {
"tags": [
"Timelogs"
],
"summary": "Get Timelogs (Account)",
"description": "Get all timelog records in current account.\n\nScopes: Default, wsReadOnly, wsReadWrite",
"operationId": "GET:/timelogs/empty",
"parameters": [
{
"name": "createdDate",
"in": "query",
"description": "Created date filter, exact match or range",
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InstantRange"
}
}
}
},
{
"name": "updatedDate",
"in": "query",
"description": "Last updated date filter, exact match or range",
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InstantRange"
}
}
}
},
{
"name": "trackedDate",
"in": "query",
"description": "Tracked date filter, exact match or range",
"required": false,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LocalDateTimeRange"
}
}
}
},
{
"name": "me",
"in": "query",
"description": "If present - only timelogs created by current user are returned",
"required": false,
"schema": {
"type": "boolean",
"description": "If present - only timelogs created by current user are returned"
}
},
{
"name": "descendants",
"in": "query",
"description": "Adds all descendant tasks to search scope",
"required": false,
"schema": {
"type": "boolean",
"description": "Adds all descendant tasks to search scope",
"default": "true"
}
},
{
"name": "plainText",
"in": "query",
"description": "Get comment text as plain text, HTML otherwise",
"required": false,
"schema": {
"type": "boolean",
"description": "Get comment text as plain text, HTML otherwise",
"default": "false"
}
},
{
"name": "timelogCategories",
"in": "query",
"description": "Get timelog records for specified categories. Limit : `1000`",
"required": false,
"content": {
"application/json": {
"schema": {
"maxItems": 1000,
"type": "array",
"description": "Get timelog records for specified categories",
"items": {
"$ref": "#/components/schemas/TimelogCategoryId"
}
}
}
}
},
{
"name": "exportStatuses",
"in": "query",
"description": "Get timelog records with specified export statuses\n* `NotExported` - Not Exported\n* `Exported` - Exported\n* `ReadyForExport` - Ready For Export",
"required": false,
"content": {
"application/json": {
"schema": {
"type": "array",
"description": "Get timelog records with specified export statuses",
"items": {
"$ref": "#/components/schemas/TimelogExportStatus"
}
}
}
}
},
{
"name": "billingTypes",
"in": "query",
"description": "Billing type filter\n* `Billable` - Billable\n* `NonBillable` - Non-Billable",
"required": false,
"content": {
"application/json": {
"schema": {
"type": "array",
"description": "Billing type filter",
"items": {
"$ref": "#/components/schemas/BillingType"
}
}
}
}
},
{
"name": "approvalStatuses",
"in": "query",
"description": "Approval status filter\n* `Draft`\n* `Approved`\n* `Rejected`\n* `Cancelled`\n* `Pending`",
"required": false,
"content": {
"application/json": {
"schema": {
"type": "array",
"description": "Approval status filter",
"items": {
"$ref": "#/components/schemas/ApprovalStatus"
}
}
}
}
},
{
"name": "limit",
"in": "query",
"description": "Limit on number of returned timelogs",
"required": false,
"schema": {
"type": "number",
"description": "Limit on number of returned timelogs"
}
},
{
"name": "pageSize",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "number",
"description": "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."
}
},
{
"name": "nextPageToken",
"in": "query",
"description": "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.",
"required": false,
"schema": {
"type": "string",
"description": "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."
}
},
{
"name": "fields",
"in": "query",
"description": "Json string array of optional fields to be included in the response model\n* `approvalStatus` - Timesheet approval status\n* `lockStatus` - Timelog lock status\n* `exportStatus` - Timelog export status field\n* `billingType` - Timelog billing type",
"required": false,
"content": {
"application/json": {
"schema": {
"type": "array",
"description": "Json string array of optional fields to be included in the response model",
"items": {
"type": "string",
"enum": [
"approvalStatus",
"lockStatus",
"exportStatus",
"billingType"
]
}
}
}
}
}
],
"responses": {
"2XX": {
"description": "success response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Timelog"
}
},
"kind": {
"$ref": "#/components/schemas/ResponseKind"
}
}
}
}
}
},
"4XX": {
"description": "client-side error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"5XX": {
"description": "server-side error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
},
"security": [
{
"HTTP": []
}
]
}
}
},
"components": {
"schemas": {
"ResponseKind": {
"type": "string",
"enum": [
"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",
"cascadingFieldSettings"
]
},
"TimelogExportStatus": {
"type": "string",
"description": "* `NotExported` - Not Exported\n* `Exported` - Exported\n* `ReadyForExport` - Ready For Export",
"enum": [
"NotExported",
"Exported",
"ReadyForExport"
]
},
"InstantRange": {
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Range start
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
},
"end": {
"type": "string",
"description": "Range end
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
}
}
},
"ErrorType": {
"type": "string",
"enum": [
"invalid_request",
"invalid_parameter",
"parameter_required",
"not_authorized",
"access_forbidden",
"not_allowed",
"resource_not_found",
"method_not_found",
"too_many_requests",
"rate_limit_exceeded",
"server_error"
]
},
"ErrorResponse": {
"type": "object",
"properties": {
"errorDescription": {
"type": "string"
},
"error": {
"$ref": "#/components/schemas/ErrorType"
}
}
},
"LocalDateTimeRange": {
"type": "object",
"properties": {
"equal": {
"type": "string",
"description": "Date exact match value
Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)"
},
"start": {
"type": "string",
"description": "Range start
Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)"
},
"end": {
"type": "string",
"description": "Range end
Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional)"
}
}
},
"BillingType": {
"type": "string",
"description": "* `Billable` - Billable\n* `NonBillable` - Non-Billable",
"enum": [
"Billable",
"NonBillable"
]
},
"TimelogId": {
"pattern": "^([A-Z0-9]){16}$",
"type": "string"
},
"ApprovalStatus": {
"type": "string",
"description": "* `Draft`\n* `Approved`\n* `Rejected`\n* `Cancelled`\n* `Pending`",
"enum": [
"Draft",
"Approved",
"Rejected",
"Cancelled",
"Pending"
]
},
"TaskId": {
"pattern": "^([a-zA-Z0-9-_:\\.=]){1,256}$",
"type": "string"
},
"TimelogFinance": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "Currency"
},
"actualFees": {
"type": "number",
"description": "Actual fees"
},
"actualCost": {
"type": "number",
"description": "Actual cost"
}
}
},
"TimelogLockStatus": {
"type": "string",
"description": "* `Locked` - Locked\n* `Unlocked` - Unlocked",
"enum": [
"Locked",
"Unlocked"
]
},
"TimesheetApprovalStatus": {
"type": "string",
"description": "* `NotSubmitted`\n* `Approved`\n* `Rejected`\n* `Pending`",
"enum": [
"NotSubmitted",
"Approved",
"Rejected",
"Pending"
]
},
"TimelogCategoryId": {
"pattern": "^([A-Z0-9]){16}$",
"type": "string"
},
"Timelog": {
"type": "object",
"properties": {
"approvalStatus": {
"$ref": "#/components/schemas/TimesheetApprovalStatus"
},
"hours": {
"type": "number",
"description": "Hours tracked in timelog record, must be in [0..24] hours range"
},
"exportStatus": {
"$ref": "#/components/schemas/TimelogExportStatus"
},
"updatedDate": {
"type": "string",
"description": "Date of timelog was updated
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
},
"userId": {
"$ref": "#/components/schemas/UserId"
},
"createdDate": {
"type": "string",
"description": "Date of timelog was created
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
},
"lockStatus": {
"$ref": "#/components/schemas/TimelogLockStatus"
},
"billingType": {
"$ref": "#/components/schemas/BillingType"
},
"trackedDate": {
"type": "string",
"description": "Date for which timelog was recorded
Format: yyyy-MM-dd"
},
"comment": {
"type": "string",
"description": "Timelog record comment"
},
"id": {
"$ref": "#/components/schemas/TimelogId"
},
"taskId": {
"$ref": "#/components/schemas/TaskId"
},
"categoryId": {
"$ref": "#/components/schemas/TimelogCategoryId"
},
"finance": {
"$ref": "#/components/schemas/TimelogFinance"
}
}
},
"UserId": {
"pattern": "^([A-Z0-9]){8}$",
"type": "string"
}
},
"securitySchemes": {
"HTTP": {
"type": "http",
"description": "Use OAuth 2.0 access token or permanent access token for authorization.",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
}
}
```