get_folders()

Client.get_folders()

Get one or more folders by using folder identifiers.

Usable by Users Bots
Parameters:

folder_ids (``int`` | Iterable of ``int``, *optional*) – Pass a single folder identifier or an iterable of folder ids (as integers) to get the content of the folders themselves. By default all folders are returned.

Returns:

  • :obj:`~pyrogram.types.Folder` | List of :obj:`~pyrogram.types.Folder` (In case *folder_ids was not*)

  • a list, a single folder is returned, otherwise a list of folders is returned.

Example

# Get one folder
await app.get_folders(12345)

# Get more than one folders (list of folders)
await app.get_folders([12345, 12346])

# Get all folders
await app.get_folders()