messages.getHistory

Returns the conversation history with one interlocutor / within a chat

messages.messages#8c718e87 messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.messagesSlice#3a54685e flags:# inexact:flags.1?true count:int next_rate:flags.0?int offset_id_offset:flags.2?int messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.channelMessages#c776ba4e flags:# inexact:flags.1?true pts:int count:int offset_id_offset:flags.2?int messages:Vector<Message> topics:Vector<ForumTopic> chats:Vector<Chat> users:Vector<User> = messages.Messages;
messages.messagesNotModified#74535f21 count:int = messages.Messages;
---functions---
messages.getHistory#4423e6c5 peer:InputPeer offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages;

Parameters

Name Type Description
peer InputPeer Target peer
offset_id int Only return messages starting from the specified message ID
offset_date int Only return messages sent before the specified date
add_offset int Number of list elements to be skipped, negative values are also accepted.
limit int Number of results to return
max_id int If a positive value was transferred, the method will return only messages with IDs less than max_id
min_id int If a positive value was transferred, the method will return only messages with IDs more than min_id
hash long Result hash

Result

messages.Messages

Possible errors

Code Type Description
400 CHANNEL_INVALID The provided channel is invalid.
406 CHANNEL_PRIVATE You haven't joined this channel/supergroup.
400 CHAT_ID_INVALID The provided chat id is invalid.
400 MSG_ID_INVALID Invalid message ID provided.
400 PEER_ID_INVALID The provided peer id is invalid.
400 TAKEOUT_INVALID The specified takeout ID is invalid.

Related pages

Pagination in the API

How to fetch results from large lists of objects.