# Method: messages.getDialogs

Back to methods index

Returns the current user dialog list.

# Parameters:

Name Type Description Required
exclude_pinned Bool Exclude pinned dialogs Optional
folder_id int Peer folder ID, for more info click here Optional
offset_date int Offsets for pagination, for more info click here Yes
offset_id int Offsets for pagination, for more info click here Yes
offset_peer Username, chat ID, Update, Message or InputPeer Offset peer for pagination Optional
limit int Number of list elements to be returned Yes
hash Array of int Hash for pagination, for more info click here Optional

# Return type: messages.Dialogs

# Can bots use this method: NO

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$messages_Dialogs = $MadelineProto->messages->getDialogs(['exclude_pinned' => Bool, 'folder_id' => int, 'offset_date' => int, 'offset_id' => int, 'offset_peer' => InputPeer, 'limit' => int, 'hash' => [int, int], ]);

Or, if you’re into Lua:

messages_Dialogs = messages.getDialogs({exclude_pinned=Bool, folder_id=int, offset_date=int, offset_id=int, offset_peer=InputPeer, limit=int, hash={int}, })

# Errors

Code Type Description
400 FOLDER_ID_INVALID Invalid folder ID
400 INPUT_CONSTRUCTOR_INVALID The provided constructor is invalid
400 OFFSET_PEER_ID_INVALID The provided offset peer is invalid
406 AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
401 SESSION_PASSWORD_NEEDED 2FA is enabled, use a password to login
-504 memory limit exit Internal error
-503 Timeout Timeout while fetching data
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.