Returns the current user’s notifications.

This method requires the following permissions: notifications.

Parameters

offset
integer (non-negative)

Offset into the list of notifications for pagination.

count
integer (1..100)

How many notifications to return.

By default 50.

max_id
integer (positive)

The identifier of the most recent notification known to the client. Use this to get a consistent view of the list even if new notifications were added between requests for subsequent pages.

Result

An object:

items
array of objects

Notifications themselves.

id
integer (positive)

Identifier of this notification. The newer the notification, the greater the identifier.

type
enum

Notification type.

Notifications of types like, repost, invite_signup, friend_accept, and follow are grouped together within a day and use user_ids. The other types are a single notification per action.

  • comment – Someone commented on a piece of content created by the current user
  • reply – Someone replied to a current user’s comment
  • mention – Someone mentioned the current user
  • repost – Someone reposted a current user’s post or comment
  • like – Someone liked a piece of content created by the current user
  • wall_post – Someone posted on the current user’s wall
  • invite_signup – Someone signed up using an invitation from the current user
  • follow – Someone started following the current user
  • friend_accept – Someone accepted a current user’s friend request
user_ids
object

For groupable notifications: information about users that did the action determined by type.

count
integer

How many users there are total.

items
array of integers

Identifiers of the most recent 10 users.

user_id
integer (positive)

For non-groupable notifications: the identifier of the user that did the action determined by type.

date
integer

The time (in unixtime) when this notification was created.

feedback
object

For notifications of types comment, reply, mention, wall_post: the post or comment object that this notification is about.

type
enum

The type of the object.

Possible values: wall_post, wall_comment, comment.

wall_post
wall post

If type is wall_post, the post.

wall_comment
wall post

If type is wall_comment, the comment.

comment
comment

If type is comment, the comment.

object
object

For comment: the current user’s object that on which someone commented.
For reply: the current user’s comment to which someone replied.
For like: the current user’s object that someone liked.
For repost: the current user’s wall post or comment that someone reposted.

type
enum

The type of the object.

Possible values: wall_post, wall_comment, comment, photo.

wall_post
wall post

If type is wall_post, the post.

wall_comment
wall post

If type is wall_comment, the comment.

comment
comment

If type is comment, the comment.

photo
photo

If type is photo, the photo.

parent
object

For like and repost of a comment, and for reply: the parent object for the entire comment thread.

type
enum

The type of the object.

Possible values: wall_post, photo, board_topic.

wall_post
wall post

If type is wall_post, the post.

photo
photo

If type is photo, the photo.

board_topic
board topic

If type is board_topic, the topic.

profiles
array of users

User objects relevant to these notifications.

groups
array of groups

Group objects relevant to these notifications.

last_viewed
integer (positive)

The identifier of the most recent notification seen by the user.

Errors

Global errors may occur when calling this method.