Returns the list of mutual friends between two users.

This method requires the following permissions: friends:read.

Parameters

source_user_id
integer (positive)

Identifier of the user whose friend list needs to be intersected with target_user_id. By default, the current user ID.

target_user_id
integer (positive)

Identifier of the user with whom mutual friends need to be found.

order
enum

In which order to return the friends.

  • id – Order by user identifiers.
  • random – Order randomly.

By default id.

fields
string

Comma-separated list of user profile fields to be returned.

offset
integer (non-negative)

Offset into the friend list for pagination.

count
integer (1..1000)

How many friends to return.

By default 100.

Result

If any fields were passed, returns a paginated list of user objects. Otherwise, returns a paginated list of user IDs.

Errors

Global errors may occur when calling this method.