Developers » API methods » Messages » messages.getDialogs
Returns a list of the current user's conversations.
This method is deprecated and may be disabled soon, please avoid using it.
This method can be called with a user token received in Standalone-app via Implicit Flow. Access rights required: messages.
This method can be called with a community token. Access rights required: messages.
offsetOffset needed to return a specific subset of messages.
int (number)
countNumber of messages to return.
positive number, default 20, maximum value 200
start_message_idID of the message from what to return dialogs.
positive number
preview_lengthNumber of characters after which to truncate a previewed message. To preview the full message, specify 0.
NOTE: Messages are not truncated by default. Messages are truncated by words.

positive number
unread1 return unread messages only.
flag, either 1 or 0, accessible for versions from 5.14
flag, either 1 or 0
flag, either 1 or 0
Show options for only old API versions
user_idID of the user whose last message in the conversation will be returned.
string, outdated option, only for versions before 5.14
Returns a list of message objects.
COMMENT: (1 of 1) There was no sample here or in the Russian original. Please provide.
Global errors can occur while running. See their descriptions on this page.
Version historyShow all
New format of stickers object. method returns all documents in items array: users documents first and documents from global search after them.

New error: 29: Rate limit reached
messages.getDialogs method returns unanswered and important fields for community dialogs.

groups.getCallbackSettings method returns wall_repost field. method returns error 15 if wallpost = 1 parameter is used and the application dont have wall permission.
Returns new objects with market and market_album type in message and wall attachments.
Returns new fields for message attachments with link type: caption, is_external, product, application, rating and button.
apps.get apps.getCatalog methods returns photo object for screenshots fields. Add in_read, out_read fields in response of messages.getDialogs, messages.getHistory and messages.getLongPollHistory methods. Add peer_id parameter for messages.send, messages.sendSticker, messages.deleteDialog, messages.setActivity and messages.getHistory methods.
In messages.getDialogs method unread parameter was added, only dialogs with unread inbound messages are returned if it is passed. Count of such dialogs was added in method result as unread_dialogs field (if positive) and count of unread inbound messages is returned for each dialog in unread field (if positive).

In messages.getHistory method rev parameter is not available to use with start_message_id parameter, behaviour of start_message_id and its link with offset has changed, count of unread inbound messages was added to result in unread field (if positive) and count of skipped messages when using start_message_id was added to result in skipped field (if positive).
In all methods that return people objects, photo, photo_medium_rec fields were renamed to photo_50, photo_100.
In wall attachment from and copy_owner fields return as user or community object, not array.
Links attached to messages now represented as attachment objects, not link in message text
Represent gifts as special object, not as attached document anymore
chat_active field returns as array, not string.
First element of result represents total count of elements.
Affects methods photos.get
offset and count could be only positive