Developers » API methods » Messages » messages.get
Returns a list of the current user's incoming private messages.
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.
positive number
countNumber of messages to return.
positive number, default 20, maximum value 200
time_offsetMaximum time since a message was sent, in seconds. To return messages without a time limitation, set as 0.
positive number
filters8 important messages.
positive number, default 0
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
last_message_idID of the message received before the message that will be returned last (provided that no more than count messages were received before it; otherwise offset parameter shall be used).
positive number
Returns a list of message objects.

Global errors can occur while running. See their descriptions on this page.
Version historyShow all
wall.getComments method returns new fields: comment_id (integer), current_level_count (integer).
wall.createComment method returns new parents_stack (array) field.
wall.getComment method has been added.

Wall comment object contains new parents_stack (array), thread (object) fields. deleted (boolean) field can be returned if the comment is deleted.

Replies (reply_message) and forwarded messages (fwd_messages) have been separated in the message object.

is_favorite (boolean) field can be returned in , , objects.
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
New chat_invite_user_by_link value has been supported in the action field of the message object.

update_time field has been added in the message object., wall.editAdsStealth, wall.edit, wall.repost methods can return a new error 224 too many ads posts.

New event message_edit has been added in Callback API.
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.
Allow only positive integers for out, time_offset, filters parameters in messages.get method. message_ids is required parameter for messages.getById method.
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.get method only two values for filter param are valid, 0 (all incoming or all outgoing messages, selected by out field) or 8 (important messages), other values are ignored.
messages.markAsNew method is not supported anymore.
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.
Empty message body in change chat photo service messages.
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