---
title: "List folders"
method: GET
path: "/api/v2/teams/{team_slug}/items/folders"
tags: ["Items"]
---

# List folders

`GET /api/v2/teams/{team_slug}/items/folders`

Returns list of all folders given provided filters.

## Path parameters

- `team_slug` string, required

## Query parameters

- `dataset_ids[]` union, required
  - CommonDatasetId[] — List of dataset IDs
  - 'all' — All dataset IDs.
  - string — [ DEPRECATED ] Comma seperated list of dataset IDs
- `has_comments` boolean — Controls whether to include only items with/without comments
- `select_all` boolean — For batch operation this filter has to be set to true if no other optional filter is provided.
- `item_path_prefix` string — Item's path prefix to match. This filter only matches on full path segments, it's not possible to match on e.g. '/some_path' with '/some' filter.
- `not_item_path_prefix` string — Item's path prefix to match. This filter only matches on full path segments, it's not possible to match on e.g. '/some_path' with '/some' filter.
- `item_paths[]` union
  - DatasetsV2FiltersItemPath[] — List of Item's path
  - string — [ DEPRECATED ] Comma separated list of Item's path
- `not_item_paths[]` union
  - DatasetsV2FiltersItemPath[] — List of Item's path
  - string — [ DEPRECATED ] Comma separated list of Item's path
- `item_ids[]` union
  - DatasetsV2FiltersItemId[] — List of Item's UUID
  - string — [ DEPRECATED ] Comma separated list of Item's UUID
- `not_item_ids[]` union
  - DatasetsV2FiltersItemId[] — List of Item's UUID
  - string — [ DEPRECATED ] Comma separated list of Item's UUID
- `item_names[]` union
  - DatasetsV2FiltersItemName[] — List of Item's name
  - string — [ DEPRECATED ] Comma separated list of Item's name
- `not_item_names[]` union
  - DatasetsV2FiltersItemName[] — List of Item's name
  - string — [ DEPRECATED ] Comma separated list of Item's name
- `item_name_prefix` string — Prefix of item's name
- `not_item_name_prefix` string — Prefix of item's name
- `item_name_contains` string — Partial item's name
- `not_item_name_contains` string — Partial item's name
- `workflow_stage_ids[]` union
  - DatasetsV2FiltersWorkflowStageId[] — List of Item's current workflow stage ID.
  - string — [ DEPRECATED ] Comma separated list of Item's current workflow stage ID.
- `not_workflow_stage_ids[]` union
  - DatasetsV2FiltersWorkflowStageId[] — List of Item's current workflow stage ID.
  - string — [ DEPRECATED ] Comma separated list of Item's current workflow stage ID.
- `types[]` union
  - DatasetsV2FiltersFileType[] — List of Type of files within the item
  - string — [ DEPRECATED ] Comma separated list of Type of files within the item
- `not_types[]` union
  - DatasetsV2FiltersFileType[] — List of Type of files within the item
  - string — [ DEPRECATED ] Comma separated list of Type of files within the item
- `statuses[]` union
  - DatasetsV2CommonGeneralStatus[] — List of General status of the Upload/Item. It considers processing status as well as workflow status and Item being archived/non-archived. Can be used instead of 'processing_status' and 'workflow_status' for simplicity. Item will be marked as 'complete' only if both workflow and processing is done.
  - string — [ DEPRECATED ] Comma separated list of General status of the Upload/Item. It considers processing status as well as workflow status and Item being archived/non-archived. Can be used instead of 'processing_status' and 'workflow_status' for simplicity. Item will be marked as 'complete' only if both workflow and processing is done.
- `not_statuses[]` union
  - DatasetsV2CommonGeneralStatus[] — List of General status of the Upload/Item. It considers processing status as well as workflow status and Item being archived/non-archived. Can be used instead of 'processing_status' and 'workflow_status' for simplicity. Item will be marked as 'complete' only if both workflow and processing is done.
  - string — [ DEPRECATED ] Comma separated list of General status of the Upload/Item. It considers processing status as well as workflow status and Item being archived/non-archived. Can be used instead of 'processing_status' and 'workflow_status' for simplicity. Item will be marked as 'complete' only if both workflow and processing is done.
- `annotation_class_ids[]` union
  - DatasetsV2FiltersAnnotationClassId[] — List of Item's class ID
  - string — [ DEPRECATED ] Comma separated list of Item's class ID
- `not_annotation_class_ids[]` union
  - DatasetsV2FiltersAnnotationClassId[] — List of Item's class ID
  - string — [ DEPRECATED ] Comma separated list of Item's class ID
- `current_assignees[]` union
  - WorkflowsV2ItemAssigneeId[] — List of Item's assignee ID
  - string — [ DEPRECATED ] Comma separated list of Item's assignee ID
- `not_current_assignees[]` union
  - WorkflowsV2ItemAssigneeId[] — List of Item's assignee ID
  - string — [ DEPRECATED ] Comma separated list of Item's assignee ID
- `assignees[]` union
  - WorkflowsV2ItemAssigneeId[] — List of Item's assignee ID
  - string — [ DEPRECATED ] Comma separated list of Item's assignee ID
- `not_assignees[]` union
  - WorkflowsV2ItemAssigneeId[] — List of Item's assignee ID
  - string — [ DEPRECATED ] Comma separated list of Item's assignee ID
- `current_path` string — Filters folders that are not in given path
- `include_thumbnails` boolean — Set to 'true' if you need the response to come with thumbnail URLs for each item.
- `hide_empty` boolean — Set to 'true' if you don't want to receive empty folders.

## Response `200`

DatasetsV2.ItemManagement.ListFoldersResponse

- DatasetsV2ItemManagementListFoldersResponse — Presents list of folders based on provided filters.
  - `folders` DatasetsV2ItemManagementFolderData[], required
    - `dataset_id` integer, required
    - `filtered_item_count` integer, required — Number of items directly under this path that match supplied filters.
    - `path` string, required — Path under which Item should be added to on Darwin platform. Should always be absolute.
    - `thumbnail_url` string — URL to thumbnail of the Slot. In order to get this please use `include_thumbnails=true` in the request.
    - `thumbnails_urls` DatasetsV2ItemManagementThumbnailUrl[]
    - `unfiltered_item_count` integer, required — Number of all items directly under this path.

## Other responses

- `401` — Common.APIError
- `404` — Common.APIError
- `422` — Unprocessible Entity

---

[API](https://skmtc.net/v7labs/apis/darwin.md) · [All operations](https://skmtc.net/v7labs/apis/darwin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/v7labs/darwin/revisions/526a5b6b4cdc/schema)