Get Friends List
Retrieves the current friend list for the local user, constrained to users who have PlayFab accounts. Friends from linked accounts (Facebook, Steam) are also included. You may optionally exclude some linked services’ friends.
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| AccountNotFound | 1001 |
| ExpiredXboxLiveToken | 1189 |
| FacebookAPIError | 1143 |
| InvalidXboxLiveToken | 1188 |
| XboxInaccessible | 1339 |
| XboxServiceTooManyRequests | 1505 |
| XboxXASSExchangeFailure | 1306 |
Authorizations
This API requires a client session ticket, available from any Client Login function.
Body
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
Indicates which other platforms' friends should be included in the response. In HTTP, it is represented as a comma-separated list of platforms.
None, Steam, Facebook, Xbox, Psn, All If true, include friends from the same namespace even if they have not logged in to the current title. Defaults to false.
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.
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.
The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.
The Http status code as a string.
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.
