MadelineProto/docs/TD_docs/methods/getChatHistory.md

title	description
getChatHistory	Returns messages in a chat. Automatically calls openChat. Returns result in reverse chronological order, i.e. in order of decreasing message.message_id

Method: getChatHistory

Back to methods index

Returns messages in a chat. Automatically calls openChat. Returns result in reverse chronological order, i.e. in order of decreasing message.message_id

Params:

Name	Type	Required	Description
chat_id	long	Yes	Chat identifier
from_message_id	long	Yes	Identifier of the message near which we need a history, you can use 0 to get results from the beginning, i.e. from oldest to newest
offset	int	Yes	Specify 0 to get results exactly from from_message_id or negative offset to get specified message and some newer messages
limit	int	Yes	Maximum number of messages to be returned, should be positive and can't be greater than 100. If offset is negative, limit must be greater than -offset. There may be less than limit messages returned even the end of the history is not reached

Return type: Messages

Example:

$MadelineProto = new \danog\MadelineProto\API();
if (isset($token)) { // Login as a bot
    $this->bot_login($token);
}
if (isset($number)) { // Login as a user
    $sentCode = $MadelineProto->phone_login($number);
    echo 'Enter the code you received: ';
    $code = '';
    for ($x = 0; $x < $sentCode['type']['length']; $x++) {
        $code .= fgetc(STDIN);
    }
    $MadelineProto->complete_phone_login($code);
}

$Messages = $MadelineProto->getChatHistory(['chat_id' => long, 'from_message_id' => long, 'offset' => int, 'limit' => int, ]);

Or, if you're into Lua:

Messages = getChatHistory({chat_id=long, from_message_id=long, offset=int, limit=int, })