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#49f0bde9 peer:InputPeer filter:MessagesFilter offset_id:int offset_date:int = messages.SearchResultsCalendar;


Name Type Description
peer InputPeer Peer where to search
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


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.