Skip to main content
POST
Get Friends List

Authorizations

X-Authorization
string
header
required

This API requires a client session ticket, available from any Client Login function.

Body

application/json
CustomTags
object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ExternalPlatformFriends
enum<string>

Indicates which other platforms' friends should be included in the response. In HTTP, it is represented as a comma-separated list of platforms.

Available options:
None,
Steam,
Facebook,
Xbox,
Psn,
All
NamespaceWide
boolean

If true, include friends from the same namespace even if they have not logged in to the current title. Defaults to false.

ProfileConstraints
object

If non-null, this determines which properties of the resulting player profiles to return. For API calls from the client, only the allowed client profile properties for the title may be requested. These allowed properties are configured in the Game Manager "Client Profile Options" tab in the "Settings" section.

XboxToken
string

Xbox token if Xbox friends should be included. Requires Xbox be configured on PlayFab. When provided, all Xbox Live users the caller is following are included regardless of whether they follow the caller back.

Response

If any additional services are queried for the user's friends, those friends who also have a PlayFab account registered for the title will be returned in the results. For Facebook, user has to have logged into the title's Facebook app recently, and only friends who also plays this game will be included. Note: If the user authenticated with AuthenticationToken when calling LoginWithFacebook, instead of AccessToken, an empty list will be returned. For Xbox Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included. Xbox Live friends include all users the caller is following, regardless of whether those users follow the caller back. This differs from FindFriendLobbies, which only considers mutual Xbox Live friends.

code
integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status
string

The Http status code as a string.

data
object

If any additional services are queried for the user's friends, those friends who also have a PlayFab account registered for the title will be returned in the results. For Facebook, user has to have logged into the title's Facebook app recently, and only friends who also plays this game will be included. Note: If the user authenticated with AuthenticationToken when calling LoginWithFacebook, instead of AccessToken, an empty list will be returned. For Xbox Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included. Xbox Live friends include all users the caller is following, regardless of whether those users follow the caller back. This differs from FindFriendLobbies, which only considers mutual Xbox Live friends.

Example:
Last modified on October 1, 2026