Returns information about the next messages of the specified type in the chat split by days.

Returns the results in reverse chronological order.
Can return partial results for the last returned day.

messages.searchResultsCalendar#147ee23c flags:# inexact:flags.0?true count:int min_date:int min_msg_id:int offset_id_offset:flags.1?int periods:Vector<SearchResultsCalendarPeriod> messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.SearchResultsCalendar;
messages.getSearchResultsCalendar#6aa3f6bd flags:# peer:InputPeer saved_peer_id:flags.2?InputPeer filter:MessagesFilter offset_id:int offset_date:int = messages.SearchResultsCalendar;


Name Type Description
flags # Flags, see TL conditional fields
peer InputPeer Peer where to search
saved_peer_id flags.2?InputPeer Search within the saved message dialog ยป with this ID.
filter MessagesFilter Message filter, inputMessagesFilterEmpty, inputMessagesFilterMyMentions filters are not supported by this method.
offset_id int Offsets for pagination, for more info click here
offset_date int Offsets for pagination, for more info click here



Possible errors

Code Type Description
400 FILTER_NOT_SUPPORTED The specified filter cannot be used in this context.

Related pages

Saved messages

The Saved Messages chat allows users to bookmark messages and media: it's a personal cloud storage for any messages or media you may want to send or forward there.


Filter is absent.


Return only messages where the current user was mentioned.

Pagination in the API

How to fetch results from large lists of objects.