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

# get_folders_summary

> Get summary information for all accessible folders

> [tab] Sync
>
> ```python theme={null}
> def get_folders_summary() -> List[FolderSummary]
> ```

> [tab] Async
>
> ```python theme={null}
> async def get_folders_summary() -> List[FolderSummary]
> ```

## Parameters

This method takes no parameters.

## Returns

* `List[FolderSummary]`: List of folder summaries with document counts

## Examples

> [tab] Sync
>
> ```python theme={null}
> from morphik import Morphik
>
> db = Morphik()
>
> # Get summary of all folders
> summaries = db.get_folders_summary()
>
> for folder in summaries:
>     print(f"Folder: {folder.name}")
>     print(f"  ID: {folder.id}")
>     print(f"  Description: {folder.description}")
>     print(f"  Document count: {folder.doc_count}")
>     print(f"  Last updated: {folder.updated_at}")
>     print("---")
>
> # Find folders with most documents
> sorted_folders = sorted(summaries, key=lambda f: f.doc_count, reverse=True)
> print(f"Largest folder: {sorted_folders[0].name} ({sorted_folders[0].doc_count} docs)")
> ```

> [tab] Async
>
> ```python theme={null}
> from morphik import AsyncMorphik
>
> async with AsyncMorphik() as db:
>     # Get summary of all folders
>     summaries = await db.get_folders_summary()
>
>     for folder in summaries:
>         print(f"Folder: {folder.name}")
>         print(f"  ID: {folder.id}")
>         print(f"  Description: {folder.description}")
>         print(f"  Document count: {folder.doc_count}")
>         print(f"  Last updated: {folder.updated_at}")
>         print("---")
>
>     # Find folders with most documents
>     sorted_folders = sorted(summaries, key=lambda f: f.doc_count, reverse=True)
>     print(f"Largest folder: {sorted_folders[0].name} ({sorted_folders[0].doc_count} docs)")
> ```

## FolderSummary Properties

The `FolderSummary` objects have the following properties:

* `id` (str): Unique folder identifier
* `name` (str): Folder name
* `full_path` (str | None): Canonical folder path (e.g., `/projects/alpha/specs`)
* `parent_id` (str | None): Parent folder ID
* `depth` (int | None): Depth in the hierarchy (root = 1)
* `description` (str | None): Folder description
* `doc_count` (int): Number of documents in the folder
* `updated_at` (str | None): Last update timestamp

## Notes

* This is a lightweight method for getting an overview of all folders.
* For more detailed information including document lists and status counts, use [`get_folders_details`](./get_folders_details).
* Returns only folders accessible to the authenticated user.


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