--- updatedAt: 2026-04-28T08:04:37.000Z agentTools: projectIndex: https://developers.wrike.com/llms.txt --- # Query 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. 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": { "/timesheets": { "get": { "tags": [ "Timesheets" ], "summary": "Query Timesheets", "description": "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.\n\nScopes: Default, wsReadOnly, wsReadWrite", "operationId": "GET:/timesheets/empty", "parameters": [ { "name": "periodStartDate", "in": "query", "description": "Returns timesheet for specified start date match or start date range filter", "required": false, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocalDateRange" } } } }, { "name": "userIds", "in": "query", "description": "UserIds filter, match of any", "required": false, "content": { "application/json": { "schema": { "type": "array", "description": "UserIds filter, match of any", "items": { "$ref": "#/components/schemas/UserId" } } } } }, { "name": "approvalStatuses", "in": "query", "description": "Approval statuses filter, match of any", "required": false, "content": { "application/json": { "schema": { "type": "array", "description": "Approval statuses filter, match of any", "items": { "type": "string" } } } } }, { "name": "timeframes", "in": "query", "description": "Timeframes filter, match of any", "required": false, "content": { "application/json": { "schema": { "type": "array", "description": "Timeframes filter, match of any", "items": { "type": "string" } } } } } ], "responses": { "2XX": { "description": "success response", "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "$ref": "#/components/schemas/ResponseKind" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Timesheet" } } } } } } }, "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", "blueprintSearch", "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", "mcpFeatures", "attachmentUploadUrl", "userAggregatedCapacity", "cascadingFieldSettings", "recommendResources", "aggregatedAllocatedEffort", "aggregatedTotalUserEffort", "aggregatedTimeSpent", "folderBlueprint", "taskBlueprint" ] }, "Timesheet": { "type": "object", "properties": { "timesheetId": { "$ref": "#/components/schemas/TimesheetPeriodId" }, "accountId": { "$ref": "#/components/schemas/AccountId" }, "periodStartDate": { "type": "string", "description": "Date of when the timesheet started
Format: yyyy-MM-dd'T'HH:mm:ss'Z'" }, "timeframe": { "$ref": "#/components/schemas/TimeframeType" }, "approval": { "$ref": "#/components/schemas/TimesheetApproval" }, "rows": { "type": "array", "description": "List of timesheet rows", "items": { "$ref": "#/components/schemas/TimesheetRow" } }, "userId": { "$ref": "#/components/schemas/UserId" }, "periodEndDate": { "type": "string", "description": "Date of when the timesheet ended
Format: yyyy-MM-dd'T'HH:mm:ss'Z'" } } }, "TimeframeType": { "type": "string", "description": "* `Monthly`\n* `Weekly`", "enum": [ "Monthly", "Weekly" ] }, "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" ] }, "EntityTypeId": { "pattern": "^([A-Z0-9]){16}$", "type": "string" }, "ErrorResponse": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ErrorType" }, "errorDescription": { "type": "string" } } }, "AccountId": { "pattern": "^([A-Z0-9]){8}$", "type": "string" }, "TimesheetRowId": { "pattern": "^([A-Z0-9]){16}$", "type": "string" }, "TimelogId": { "pattern": "^([A-Z0-9]){16}$", "type": "string" }, "LocalDateRange": { "type": "object", "properties": { "equal": { "type": "string", "description": "Date exact match value
Format: yyyy-MM-dd" }, "start": { "type": "string", "description": "Range start
Format: yyyy-MM-dd" }, "end": { "type": "string", "description": "Range end
Format: yyyy-MM-dd" } } }, "TimesheetPeriodId": { "pattern": "^([A-Z0-9]){16}$", "type": "string" }, "FolderId": { "pattern": "^([a-zA-Z0-9-_:\\.=]){1,256}$", "type": "string" }, "TimesheetApprovalStatus": { "type": "string", "description": "* `NotSubmitted`\n* `Approved`\n* `Rejected`\n* `Pending`", "enum": [ "NotSubmitted", "Approved", "Rejected", "Pending" ] }, "TimelogCategoryId": { "pattern": "^([A-Z0-9]){16}$", "type": "string" }, "TimesheetRow": { "required": [ "categoryId", "parentIds", "rowId", "taskId", "type", "weeklyEntries" ], "type": "object", "properties": { "parentIds": { "type": "array", "description": "List of entry parent folder IDs", "items": { "$ref": "#/components/schemas/FolderId" } }, "type": { "$ref": "#/components/schemas/EntityTypeId" }, "weeklyEntries": { "type": "array", "description": "List of weekly entries per row", "items": { "$ref": "#/components/schemas/TimesheetRowWeeklyEntry" } }, "taskId": { "type": "string", "description": "Task ID associated with this row" }, "categoryId": { "$ref": "#/components/schemas/TimelogCategoryId" }, "rowId": { "$ref": "#/components/schemas/TimesheetRowId" } } }, "TimesheetApproval": { "required": [ "approvalChangeDate", "approvalStatus", "approverId", "submissionChangeDate", "submitterId" ], "type": "object", "properties": { "approvalStatus": { "$ref": "#/components/schemas/TimesheetApprovalStatus" }, "approvalChangeDate": { "type": "string", "description": "Date of when the timesheet was approved or rejected
Format: yyyy-MM-dd'T'HH:mm:ss'Z'" }, "submitterId": { "type": "string", "description": "User ID of the person who submitted the timesheet" }, "approverId": { "type": "string", "description": "User ID of the approver" }, "submissionChangeDate": { "type": "string", "description": "Date of when the timesheet was submitted
Format: yyyy-MM-dd'T'HH:mm:ss'Z'" } } }, "TimesheetRowWeeklyEntry": { "required": [ "date", "entriesIds", "sum" ], "type": "object", "properties": { "date": { "type": "string", "description": "Date of the entry
Format: yyyy-MM-dd'T'HH:mm:ss'Z'" }, "entriesIds": { "type": "array", "description": "List of time entry IDs", "items": { "$ref": "#/components/schemas/TimelogId" } }, "sum": { "type": "number", "description": "Sum of hours logged for this date" } } }, "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" } } } } ```