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

# list

> List every knowledge base in the organization.

`KnowledgeBases.alist` returns every knowledge base your organization owns.

```python theme={"dark"}
from xpander_sdk import KnowledgeBases

kbs = await KnowledgeBases().alist()
for kb in kbs:
    print(kb.id, kb.name, kb.total_documents)
```

### Parameters

None.

### Returns `list[KnowledgeBase]`

Each `KnowledgeBase` is a full instance. See the [`KnowledgeBase` class reference](/developers/sdk-reference/knowledge-bases/knowledge-base) for fields and methods.

| Field             | Type                | Description                                                           |
| ----------------- | ------------------- | --------------------------------------------------------------------- |
| `id`              | `str`               | Knowledge-base identifier.                                            |
| `name`            | `str`               | Display name.                                                         |
| `description`     | `str \| None`       | Description.                                                          |
| `type`            | `KnowledgeBaseType` | `MANAGED` (xpander.ai vector store) or `EXTERNAL` (provider-managed). |
| `organization_id` | `str`               | Owning org.                                                           |
| `total_documents` | `int`               | Document count.                                                       |

## Sync version

```python theme={"dark"}
kbs = KnowledgeBases().list()
```

## Errors

Raises [`ModuleException`](/developers/sdk-reference/error-handling) on failure.