> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lacy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List folders

> List the folders in your account

Folders let you group assistants (for example, by client or brand). Each assistant can belong to a single folder. Folders are private to your account.

This endpoint returns your folders (paginated), each with the number of assistants it contains.

### Query Parameters

**per\_page** `integer`

Number of folders per page (1-100, default: 15)

**page** `integer`

Page number (default: 1)

### Response fields

**data** `array`

**properties**

**id** `integer`

The unique identifier of the folder

**name** `string`

The folder name

**color** `string`

The folder color (or `null`)

**assistants\_count** `integer`

Number of assistants in this folder

```json 200 Success Response theme={null}
{
  "data": [
    { "id": 12, "name": "Acme Corp", "color": "blue", "assistants_count": 4 },
    { "id": 18, "name": "Globex", "color": "teal", "assistants_count": 0 }
  ],
  "current_page": 1,
  "per_page": 15,
  "total": 2
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.