--- title: "Get Tasks (Account)" method: GET path: "/tasks" tags: ["Tasks"] --- # Get Tasks (Account) `GET /tasks` Search among all tasks in current account. Scopes: Default, wsReadOnly, wsReadWrite ## Query parameters - `descendants` boolean — Adds all descendant folders to search scope. Applicable only for GET/folders/{folderId}/tasks and GET/spaces/{spaceId}/tasks endpoints - `title` string — Title filter, contains match - `importance` 'High' | 'Low' | 'Normal' — * `High` * `Low` * `Normal` - `permalink` string — Task permalink, exact match - `type` 'Milestone' | 'Backlog' | 'Planned' — * `Milestone` * `Backlog` * `Planned` - `limit` number — Limit on number of returned tasks - `sortField` 'Status' | 'Importance' | 'UpdatedDate' | 'CreatedDate' | 'Title' | 'StartFinishInterval' | 'DueDate' | 'LastAccessDate' | 'CompletedDate' - `sortOrder` 'Asc' | 'Desc' — * `Asc` - Ascending sort order * `Desc` - Descending sort order - `subTasks` boolean — Adds subtasks to search scope - `pageSize` number — The number of tasks to return (max 1000 items per page) - `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. If you included optional fields to the first request, you will need to include those in each new call - `withInvitations` boolean — Include invitations in sharedIds & responsibleIds lists - `plainTextCustomFields` boolean — Strip HTML tags from custom fields ## Response `2XX` success response - object - `data` Task[] - `metadata` Metadata[] — List of task metadata entries - `value` string, required — Value should be less than 1000 symbols, compatible with JSON string. Use JSON 'null' in order to remove metadata entry - `key` string, required — Key should be less than 50 symbols and match following regular expression ([A-Za-z0-9_-]+) - `importance` 'High' | 'Low' | 'Normal' — * `High` * `Low` * `Normal` - `customFields` CustomField[] — Custom fields - `id` string, required - `value` string, required — Custom field value. 4000 characters max. Should be valid string according to JSON RFC 8259. In particular, following characters must be escaped: quotation mark, reverse solidus, and the control characters (U+0000 through U+001F). Any character may be escaped, but unnecessarily escaped character can be implicitly translated to it's unescaped version.
In addition to RFC 8259 requirements, it is not recommended to use any of control characters in CF value.
Wrike's API forbids using U+0000 in every place and U+0011 at the beginning of the CF value string.
The correct way for setting multiple values in the multiple select Custom fields is ?customFields=[{"id":"CustomFieldId","value":"[\"value1\",\"value2\"]"}]
The correct way for setting values in the people Custom fields is ?customFields=[{"id":"CustomFieldId","value":"UserId1, UserId2"}]
Note that if custom field values are passed to API as URI param of request, they must be URI encoded. Here are some examples:
"%5c" - reverse solidus (backslash)
"%5c%22" - quotation mark
"Vi%5Cu1ec7t" - unicode-escaped character in word "Việt"
- `followerIds` UserId[] — List of user IDs, who follows task - `parentIds` FolderId[] — List of task parent folder IDs - `description` string — Description - `responsiblePlaceholderIds` PlaceholderId[] — List of placeholder assignee Ids - `updatedDate` string — Updated date
Format: yyyy-MM-dd'T'HH:mm:ss'Z' - `title` string — Title, cannot be empty - `followedByMe` boolean — Is a task followed by me - `billingType` 'Billable' | 'NonBillable' — * `Billable` - Billable * `NonBillable` - Non-Billable - `scope` 'WsTask' | 'RbRoot' | 'RbFolder' | 'WsFolder' | 'WsRoot' | 'RbTask' — * `WsTask` - Task in account * `RbRoot` - Virtual Recycle Bin folder of account * `RbFolder` - Folder is in Recycle Bin (deleted folder) * `WsFolder` - Folder in account * `WsRoot` - Virtual root folder of account * `RbTask` - Task is in Recycle Bin (deleted task) - `id` string - `effortAllocation` TaskEffort - `dailyAllocationPercentage` number — Allocation in percentages per day, for effort daily mode - `mode` 'Basic' | 'Flexible' | 'FullTime' | 'None', required — * `Basic` * `Flexible` * `FullTime` * `None` - `allocatedEffort` number — Allocated Effort in minutes - `totalEffort` number — Total Effort in minutes - `responsibleAllocation` ResponsibleAllocation[] — Responsible allocations by day - `placeholderId` string - `dailyAllocation` DailyAllocation[], required — Daily allocations - `date` string, required — Allocation date
Format: yyyy-MM-dd - `effortMinutes` number, required — Effort in minutes - `userId` string - `hasAttachments` boolean — Has attachments - `subTaskIds` TaskId[] — List of subtask IDs - `recurrent` boolean — Is a task recurrent - `authorIds` UserId[] — List of author IDs (currently contains 1 element) - `responsibleIds` UserId[] — List of assignee user IDs - `customItemTypeId` string - `sharedIds` UserId[] — Users with whom the task is shared - `dates` TaskDates — Field values limits: duration - [0, 1800000) start & due - [1970-01-01T00:00:00, 2100-01-01T00:00:00) - `duration` number — Duration in minutes. Duration is present in Planned tasks and is optional for Backlog tasks.
When updating duration, ensure to re-submit the start and due dates, even if they are to stay the same. Otherwise, the dates will be cleared.
When present for Planned tasks and due date is not given, this field limit is [1, 1800000).
Note that 1 day in Wrike is equal to 8 hours, or 480 minutes. - `due` string — Due date is present only in Planned and Milestone tasks. When setting this field alone, the task will default to a milestone.
Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional) - `start` string — Start date is present only in Planned tasks. Important: If setting a start date, always include either a due date or duration.
Format: yyyy-MM-dd'T'HH:mm:ss ('T'HH:mm:ss is optional) - `workOnWeekends` boolean — Weekends are included in task scheduling - `type` 'Milestone' | 'Backlog' | 'Planned' — * `Milestone` * `Backlog` * `Planned` - `superTaskIds` TaskId[] — List of super task IDs - `priority` string — Ordering key that defines task order in tasklist - `completedDate` string — Completed date
Format: yyyy-MM-dd'T'HH:mm:ss'Z' - `superParentIds` FolderId[] — List of folder IDs inherited from parent task - `accountId` string - `dependencyIds` DependencyId[] — List of dependency IDs - `createdDate` string — Created date
Format: yyyy-MM-dd'T'HH:mm:ss'Z' - `cascadingFieldSettings` CascadingFieldSettings[] — Cascading field settings - `systemField` boolean — System field - `enabledBy` string - `enabledAt` string — Enabled at
Format: yyyy-MM-dd'T'HH:mm:ss'Z' - `fieldId` string - `customStatusId` string - `attachmentCount` number — Total count of task attachments - `workScheduleId` string - `permalink` string — Link to open task in web workspace, if user has appropriate access - `briefDescription` string — Brief description - `finance` TaskFinance - `plannedCost` number — Planned cost - `plannedFees` number — Planned fees - `currency` string — Currency - `actualFees` number — Actual fees - `actualCost` number — Actual cost - `status` 'Active' | 'Deferred' | 'Completed' | 'Cancelled' — * `Active` - Active * `Deferred` - Deferred * `Completed` - Completed * `Cancelled` - Cancelled - `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)