---
title: "List folders"
method: GET
path: "/folders"
tags: ["folders"]
---

# List folders

`GET /folders`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/folders`
- Auth: HTTP bearer

List folders

## Query parameters

- `nextToken` string
- `pageSize` integer
- `sort` 'createdAt' | 'createdAt:asc' | 'createdAt:desc' | 'modifiedAt' | 'name' | 'modifiedAt:asc' | 'name:asc' | 'modifiedAt:desc' | 'name:desc'
- `archiveReason` string
- `nameIncludes` string
- `parentFolderId` string
- `projectId` string
- `ids` string
- `name` string
- `section` 'INVENTORY' | 'NOTEBOOK'

## Response `200`

OK

- FoldersPaginatedList
  - `folders` Folder[]
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `id` string
    - `name` string
    - `parentFolderId` string, nullable: ID of the parent folder, if it exists
    - `projectId` string: ID of the containing project
  - `nextToken` string

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)