# List the lists of a vault

`GET /api/v1/vaults/{vault}/knowledge/lists`

List the lists of a vault's Knowledge by title, without their columns and items.

This endpoint also answers QUERY, with the same parameters sent in the request body. [How QUERY works](https://my.monicahq.com/docs/api/query-method).

## Parameters

- `vault` (string, required): The vault, named either by the readable name it reports as slug or by its id. A vault of another account answers 404.
- `folder` (uuid, optional): Only the lists of this folder. The id of a folder of the vault, as the knowledge folders endpoints give it. A folder of another vault answers 404.

## Returns

Every knowledge list object of the vault, without its columns and items, or an empty list. A vault of another account answers 404.

- `data` (array): Every one of the lists, whole rather than a page at a time.
- `data[]` (object): One knowledge list, without its columns and items.
- `data[].type` (string): Always knowledge_list. It names the kind of record, so a caller holding several kinds can tell them apart without looking at where they came from.
- `data[].id` (string): The id of this record, as a string even when it reads as a number. It is what every endpoint naming this record takes.
- `data[].attributes` (object): Everything the record holds.
- `data[].attributes.title` (string): The title of the list.
- `data[].attributes.description` (string): What the list is for, in Markdown as written, or null.
- `data[].attributes.folder` (object): The folder the list sits in.
- `data[].attributes.folder.id` (uuid): The id of the folder, as the knowledge folders endpoints give it.
- `data[].attributes.folder.name` (string): What the folder is called.
- `data[].attributes.created_at` (timestamp): When the list was started, as a count of seconds since 1970.
- `data[].attributes.updated_at` (timestamp): When it, one of its columns or one of its items last changed, as a count of seconds, or null.
- `data[].links` (object): Where to find this record.
- `data[].links.self` (string): The absolute address this record is read from.
- `data[].links.web` (string): The list in the application, which opens for somebody signed in rather than for a key. It is the link to give a person.

## Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in `X-RateLimit-Remaining`.

## Request

```sh
curl https://my.monicahq.com/api/v1/vaults/dunder-mifflin/knowledge/lists \
  -H "Authorization: Bearer $MONICA_TOKEN"
```

```javascript
const response = await fetch('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/knowledge/lists', {
  headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
```

```php
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/knowledge/lists');
```

## Response

`200`

```json
{
    "data": [
        {
            "type": "knowledge_list",
            "id": "e94b1c37-6a28-4d50-8b3f-2c7e9a4d1f68",
            "attributes": {
                "title": "Paper clients",
                "description": "Who buys from the **Scranton** branch.",
                "folder": {
                    "id": "2b7e4c91-0d5a-4f38-9c16-8e3a7f1b5d24",
                    "name": "Office"
                },
                "created_at": 1773331200,
                "updated_at": 1773417600
            },
            "links": {
                "self": "https://my.monicahq.com/api/v1/vaults/dunder-mifflin/knowledge/lists/e94b1c37-6a28-4d50-8b3f-2c7e9a4d1f68",
                "web": "https://my.monicahq.com/vaults/dunder-mifflin/knowledge/lists/e94b1c37-6a28-4d50-8b3f-2c7e9a4d1f68"
            }
        }
    ]
}
```
