---
title: "Get Folders (Account)"
method: GET
path: "/folders"
tags: ["Folders & Projects"]
---

# Get Folders (Account)

`GET /folders`

Returns a list of folders for the current account.<br>
The method operates in two modes:<br>
<ul>
<li><b>Folder Tree Mode</b>: Activated if no filter parameters are provided. This mode returns the account's
folders (spaces), their descendant folders, the root folder, and the recycle bin folder
(note that "deleted" parameter can affect the result, see below).
Filtering can be requested in this mode using the descendants=true parameter along with filter parameters.

<li><b>Folders Mode</b>: Activated if the parameter descendant=false is specified or if there is at least
one filter parameter, e.g., project=true. This mode returns only the account's folders filtered by the
specified parameters.
</ul>

The chosen mode can be identified by the "kind" key in the result JSON body, with "kind": "folderTree"
for Folder Tree Mode and "kind": "folders" for Folders Mode.

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

## Query parameters

- `permalink` string — Folder permalink, exact match
- `descendants` boolean — Adds all descendant folders to search scope
- `withInvitations` boolean — Include invitations in sharedIds list
- `project` boolean — Filter only projects (true) / only folders (false)
- `deleted` boolean — Get folders from Root (false) / Recycle Bin (true). This parameter does not affect method's mode.
- `plainTextCustomFields` boolean — Strip HTML tags from custom fields
- `pageSize` number — The number of folders to return (max 1000 items per page). Only 'folders' kind is supported
- `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. Only 'folders' kind is supported
- `title` string — Title filter, contains match and accepts non-blank values only

## Response `2XX`

success response

- object
  - `data` Folder[]
    - `folder-id` string, required
    - `title` string, required
  - `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)