Method: messages.getHistory

Back to methods index

Get previous messages of a group


Name Type Description Required
peer Username, chat ID, Update, Message or InputPeer The chat Optional
offset_id int The last fetched message ID, initially 0 Yes
offset_date int The date of the last previously fetched message, initially 0 Yes
add_offset int Additional offset, can be 0 Yes
limit int Number of messages to fetch Yes
max_id int Maximum message ID to fetch Yes
min_id int Minumum message ID to fetch Yes
hash Array of int IDs of messages you already fetched Optional

Return type: messages_Messages

Can bots use this method: NO

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

if (!file_exists('madeline.php')) {
    copy('', 'madeline.php');
include 'madeline.php';

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

$messages_Messages = $MadelineProto->messages->getHistory(['peer' => InputPeer, 'offset_id' => int, 'offset_date' => int, 'add_offset' => int, 'limit' => int, 'max_id' => int, 'min_id' => int, 'hash' => [int, int], ]);

Or, if you’re into Lua:

messages_Messages = messages.getHistory({peer=InputPeer, offset_id=int, offset_date=int, add_offset=int, limit=int, max_id=int, min_id=int, hash={int}, })

Errors this method can return:

Error Description
CHANNEL_INVALID The provided channel is invalid
CHANNEL_PRIVATE You haven’t joined this channel/supergroup
CHAT_ID_INVALID The provided chat id is invalid
PEER_ID_INVALID The provided peer id is invalid
AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
AUTH_KEY_PERM_EMPTY The temporary auth key must be binded to the permanent auth key to use these methods.
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.