Share via

Friend List Management - Get Friends List

  • Reference
Service:
Server
API Version:
241025

Retrieves the current friends for the user with PlayFabId, constrained to users who have PlayFab accounts. Friends from linked accounts (Facebook, Steam) are also included. You may optionally exclude some linked services' friends.

POST https://titleId.playfabapi.com/Server/GetFriendsList

Request Header

Name Required Type Description
X-SecretKey True

string

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Request Body

Name Required Type Description
PlayFabId True

string

PlayFab identifier of the player whose friend list to get.
CustomTags

object

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

ExternalFriendSources

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

PlayerProfileViewConstraints

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.

Responses

Name Type Description
200 OK

GetFriendsListResult

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. For Xbox Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included.
400 Bad Request

ApiErrorWrapper

This is the outer wrapper for all responses with errors

Security

X-SecretKey

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Type: apiKey
In: header

Definitions

Name Description
AdCampaignAttributionModel
ApiErrorWrapper

The basic wrapper around every failed API response
ContactEmailInfoModel
ContinentCode
CountryCode
Currency
EmailVerificationStatus
ExternalFriendSources
FriendInfo
GetFriendsListRequest
GetFriendsListResult

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. For Xbox Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included.
LinkedPlatformAccountModel
LocationModel
LoginIdentityProvider
MembershipModel
PlayerProfileModel
PlayerProfileViewConstraints
PushNotificationPlatform
PushNotificationRegistrationModel
StatisticModel
SubscriptionModel
SubscriptionProviderStatus
TagModel
TitleActivationStatus
UserFacebookInfo
UserGameCenterInfo
UserPsnInfo
UserSteamInfo
UserXboxInfo
ValueToDateModel

AdCampaignAttributionModel

Name Type Description
AttributedAt

string

UTC time stamp of attribution
CampaignId

string

Attribution campaign identifier
Platform

string

Attribution network name

ApiErrorWrapper

The basic wrapper around every failed API response

Name Type Description
code

integer

Numerical HTTP code
error

string

Playfab error code
errorCode

integer

Numerical PlayFab error code
errorDetails

object

Detailed description of individual issues with the request object
errorMessage

string

Description for the PlayFab errorCode
status

string

String HTTP code

ContactEmailInfoModel

Name Type Description
EmailAddress

string

The email address
Name

string

The name of the email info data
VerificationStatus

EmailVerificationStatus

The verification status of the email

ContinentCode

Name Type Description
AF

string

AN

string

AS

string

EU

string

NA

string

OC

string

SA

string

Unknown

string

CountryCode

Name Type Description
AD

string

AE

string

AF

string

AG

string

AI

string

AL

string

AM

string

AO

string

AQ

string

AR

string

AS

string

AT

string

AU

string

AW

string

AX

string

AZ

string

BA

string

BB

string

BD

string

BE

string

BF

string

BG

string

BH

string

BI

string

BJ

string

BL

string

BM

string

BN

string

BO

string

BQ

string

BR

string

BS

string

BT

string

BV

string

BW

string

BY

string

BZ

string

CA

string

CC

string

CD

string

CF

string

CG

string

CH

string

CI

string

CK

string

CL

string

CM

string

CN

string

CO

string

CR

string

CU

string

CV

string

CW

string

CX

string

CY

string

CZ

string

DE

string

DJ

string

DK

string

DM

string

DO

string

DZ

string

EC

string

EE

string

EG

string

EH

string

ER

string

ES

string

ET

string

FI

string

FJ

string

FK

string

FM

string

FO

string

FR

string

GA

string

GB

string

GD

string

GE

string

GF

string

GG

string

GH

string

GI

string

GL

string

GM

string

GN

string

GP

string

GQ

string

GR

string

GS

string

GT

string

GU

string

GW

string

GY

string

HK

string

HM

string

HN

string

HR

string

HT

string

HU

string

ID

string

IE

string

IL

string

IM

string

IN

string

IO

string

IQ

string

IR

string

IS

string

IT

string

JE

string

JM

string

JO

string

JP

string

KE

string

KG

string

KH

string

KI

string

KM

string

KN

string

KP

string

KR

string

KW

string

KY

string

KZ

string

LA

string

LB

string

LC

string

LI

string

LK

string

LR

string

LS

string

LT

string

LU

string

LV

string

LY

string

MA

string

MC

string

MD

string

ME

string

MF

string

MG

string

MH

string

MK

string

ML

string

MM

string

MN

string

MO

string

MP

string

MQ

string

MR

string

MS

string

MT

string

MU

string

MV

string

MW

string

MX

string

MY

string

MZ

string

NA

string

NC

string

NE

string

NF

string

NG

string

NI

string

NL

string

NO

string

NP

string

NR

string

NU

string

NZ

string

OM

string

PA

string

PE

string

PF

string

PG

string

PH

string

PK

string

PL

string

PM

string

PN

string

PR

string

PS

string

PT

string

PW

string

PY

string

QA

string

RE

string

RO

string

RS

string

RU

string

RW

string

SA

string

SB

string

SC

string

SD

string

SE

string

SG

string

SH

string

SI

string

SJ

string

SK

string

SL

string

SM

string

SN

string

SO

string

SR

string

SS

string

ST

string

SV

string

SX

string

SY

string

SZ

string

TC

string

TD

string

TF

string

TG

string

TH

string

TJ

string

TK

string

TL

string

TM

string

TN

string

TO

string

TR

string

TT

string

TV

string

TW

string

TZ

string

UA

string

UG

string

UM

string

US

string

UY

string

UZ

string

Unknown

string

VA

string

VC

string

VE

string

VG

string

VI

string

VN

string

VU

string

WF

string

WS

string

YE

string

YT

string

ZA

string

ZM

string

ZW

string

Currency

Name Type Description
AED

string

AFN

string

ALL

string

AMD

string

ANG

string

AOA

string

ARS

string

AUD

string

AWG

string

AZN

string

BAM

string

BBD

string

BDT

string

BGN

string

BHD

string

BIF

string

BMD

string

BND

string

BOB

string

BRL

string

BSD

string

BTN

string

BWP

string

BYR

string

BZD

string

CAD

string

CDF

string

CHF

string

CLP

string

CNY

string

COP

string

CRC

string

CUC

string

CUP

string

CVE

string

CZK

string

DJF

string

DKK

string

DOP

string

DZD

string

EGP

string

ERN

string

ETB

string

EUR

string

FJD

string

FKP

string

GBP

string

GEL

string

GGP

string

GHS

string

GIP

string

GMD

string

GNF

string

GTQ

string

GYD

string

HKD

string

HNL

string

HRK

string

HTG

string

HUF

string

IDR

string

ILS

string

IMP

string

INR

string

IQD

string

IRR

string

ISK

string

JEP

string

JMD

string

JOD

string

JPY

string

KES

string

KGS

string

KHR

string

KMF

string

KPW

string

KRW

string

KWD

string

KYD

string

KZT

string

LAK

string

LBP

string

LKR

string

LRD

string

LSL

string

LYD

string

MAD

string

MDL

string

MGA

string

MKD

string

MMK

string

MNT

string

MOP

string

MRO

string

MUR

string

MVR

string

MWK

string

MXN

string

MYR

string

MZN

string

NAD

string

NGN

string

NIO

string

NOK

string

NPR

string

NZD

string

OMR

string

PAB

string

PEN

string

PGK

string

PHP

string

PKR

string

PLN

string

PYG

string

QAR

string

RON

string

RSD

string

RUB

string

RWF

string

SAR

string

SBD

string

SCR

string

SDG

string

SEK

string

SGD

string

SHP

string

SLL

string

SOS

string

SPL

string

SRD

string

STD

string

SVC

string

SYP

string

SZL

string

THB

string

TJS

string

TMT

string

TND

string

TOP

string

TRY

string

TTD

string

TVD

string

TWD

string

TZS

string

UAH

string

UGX

string

USD

string

UYU

string

UZS

string

VEF

string

VND

string

VUV

string

WST

string

XAF

string

XCD

string

XDR

string

XOF

string

XPF

string

YER

string

ZAR

string

ZMW

string

ZWD

string

EmailVerificationStatus

Name Type Description
Confirmed

string

Pending

string

Unverified

string

ExternalFriendSources

Name Type Description
All

string

Facebook

string

None

string

Psn

string

Steam

string

Xbox

string

FriendInfo

Name Type Description
FacebookInfo

UserFacebookInfo

Available Facebook information (if the user and connected Facebook friend both have PlayFab Accounts in the same title).
FriendPlayFabId

string

PlayFab unique identifier for this friend.
GameCenterInfo

UserGameCenterInfo

Available Game Center information (if the user and connected Game Center friend both have PlayFab Accounts in the same title).
PSNInfo

UserPsnInfo

Available PlayStation ™️ Network information, if the user connected PlayStation :tm Network friend both have PlayFab Accounts in the same title.
Profile

PlayerProfileModel

The profile of the user, if requested.
SteamInfo

UserSteamInfo

Available Steam information (if the user and connected Steam friend both have PlayFab Accounts in the same title).
Tags

string[]

Tags which have been associated with this friend.
TitleDisplayName

string

Title-specific display name for this friend.
Username

string

PlayFab unique username for this friend.
XboxInfo

UserXboxInfo

Available Xbox information, (if the user and connected Xbox Live friend both have PlayFab Accounts in the same title).

GetFriendsListRequest

Name Type Description
CustomTags

object

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

ExternalFriendSources

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

string

PlayFab identifier of the player whose friend list to get.
ProfileConstraints

PlayerProfileViewConstraints

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.

GetFriendsListResult

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. For Xbox Live, user has to have logged into the Xbox Live recently, and only friends who also play this game will be included.

Name Type Description
Friends

FriendInfo[]

Array of friends found.

LinkedPlatformAccountModel

Name Type Description
Email

string

Linked account email of the user on the platform, if available
Platform

LoginIdentityProvider

Authentication platform
PlatformUserId

string

Unique account identifier of the user on the platform
Username

string

Linked account username of the user on the platform, if available

LocationModel

Name Type Description
City

string

City name.
ContinentCode

ContinentCode

The two-character continent code for this location
CountryCode

CountryCode

The two-character ISO 3166-1 country code for the country associated with the location
Latitude

number

Latitude coordinate of the geographic location.
Longitude

number

Longitude coordinate of the geographic location.

LoginIdentityProvider

Name Type Description
AndroidDevice

string

Apple

string

Custom

string

CustomServer

string

Facebook

string

FacebookInstantGames

string

GameCenter

string

GameServer

string

GooglePlay

string

GooglePlayGames

string

IOSDevice

string

King

string

Kongregate

string

NintendoSwitch

string

NintendoSwitchAccount

string

OpenIdConnect

string

PSN

string

PlayFab

string

Steam

string

Twitch

string

Unknown

string

WindowsHello

string

XBoxLive

string

XboxMobileStore

string

MembershipModel

Name Type Description
IsActive

boolean

Whether this membership is active. That is, whether the MembershipExpiration time has been reached.
MembershipExpiration

string

The time this membership expires
MembershipId

string

The id of the membership
OverrideExpiration

string

Membership expirations can be explicitly overridden (via game manager or the admin api). If this membership has been overridden, this will be the new expiration time.
OverrideIsSet

boolean

Whether the override expiration is set.
Subscriptions

SubscriptionModel[]

The list of subscriptions that this player has for this membership

PlayerProfileModel

Name Type Description
AdCampaignAttributions

AdCampaignAttributionModel[]

List of advertising campaigns the player has been attributed to
AvatarUrl

string

URL of the player's avatar image
BannedUntil

string

If the player is currently banned, the UTC Date when the ban expires
ContactEmailAddresses

ContactEmailInfoModel[]

List of all contact email info associated with the player account
Created

string

Player record created
DisplayName

string

Player display name
ExperimentVariants

string[]

List of experiment variants for the player. Note that these variants are not guaranteed to be up-to-date when returned during login because the player profile is updated only after login. Instead, use the LoginResult.TreatmentAssignment property during login to get the correct variants and variables.
LastLogin

string

UTC time when the player most recently logged in to the title
LinkedAccounts

LinkedPlatformAccountModel[]

List of all authentication systems linked to this player account
Locations

LocationModel[]

List of geographic locations from which the player has logged in to the title
Memberships

MembershipModel[]

List of memberships for the player, along with whether are expired.
Origination

LoginIdentityProvider

Player account origination
PlayerId

string

PlayFab player account unique identifier
PublisherId

string

Publisher this player belongs to
PushNotificationRegistrations

PushNotificationRegistrationModel[]

List of configured end points registered for sending the player push notifications
Statistics

StatisticModel[]

List of leaderboard statistic values for the player
Tags

TagModel[]

List of player's tags for segmentation
TitleId

string

Title ID this player profile applies to
TotalValueToDateInUSD

number

Sum of the player's purchases made with real-money currencies, converted to US dollars equivalent and represented as a whole number of cents (1/100 USD). For example, 999 indicates nine dollars and ninety-nine cents.
ValuesToDate

ValueToDateModel[]

List of the player's lifetime purchase totals, summed by real-money currency

PlayerProfileViewConstraints

Name Type Description
ShowAvatarUrl

boolean

Whether to show player's avatar URL. Defaults to false
ShowBannedUntil

boolean

Whether to show the banned until time. Defaults to false
ShowCampaignAttributions

boolean

Whether to show campaign attributions. Defaults to false
ShowContactEmailAddresses

boolean

Whether to show contact email addresses. Defaults to false
ShowCreated

boolean

Whether to show the created date. Defaults to false
ShowDisplayName

boolean

Whether to show the display name. Defaults to false
ShowExperimentVariants

boolean

Whether to show player's experiment variants. Defaults to false
ShowLastLogin

boolean

Whether to show the last login time. Defaults to false
ShowLinkedAccounts

boolean

Whether to show the linked accounts. Defaults to false
ShowLocations

boolean

Whether to show player's locations. Defaults to false
ShowMemberships

boolean

Whether to show player's membership information. Defaults to false
ShowOrigination

boolean

Whether to show origination. Defaults to false
ShowPushNotificationRegistrations

boolean

Whether to show push notification registrations. Defaults to false
ShowStatistics

boolean

Reserved for future development
ShowTags

boolean

Whether to show tags. Defaults to false
ShowTotalValueToDateInUsd

boolean

Whether to show the total value to date in usd. Defaults to false
ShowValuesToDate

boolean

Whether to show the values to date. Defaults to false

PushNotificationPlatform

Name Type Description
ApplePushNotificationService

string

GoogleCloudMessaging

string

PushNotificationRegistrationModel

Name Type Description
NotificationEndpointARN

string

Notification configured endpoint
Platform

PushNotificationPlatform

Push notification platform

StatisticModel

Name Type Description
Name

string

Statistic name
Value

number

Statistic value
Version

number

Statistic version (0 if not a versioned statistic)

SubscriptionModel

Name Type Description
Expiration

string

When this subscription expires.
InitialSubscriptionTime

string

The time the subscription was orignially purchased
IsActive

boolean

Whether this subscription is currently active. That is, if Expiration > now.
Status

SubscriptionProviderStatus

The status of this subscription, according to the subscription provider.
SubscriptionId

string

The id for this subscription
SubscriptionItemId

string

The item id for this subscription from the primary catalog
SubscriptionProvider

string

The provider for this subscription. Apple or Google Play are supported today.

SubscriptionProviderStatus

Name Type Description
BillingError

string

Cancelled

string

CustomerDidNotAcceptPriceChange

string

FreeTrial

string

NoError

string

PaymentPending

string

ProductUnavailable

string

UnknownError

string

TagModel

Name Type Description
TagValue

string

Full value of the tag, including namespace

TitleActivationStatus

Name Type Description
ActivatedSteam

string

ActivatedTitleKey

string

None

string

PendingSteam

string

RevokedSteam

string

UserFacebookInfo

Name Type Description
FacebookId

string

Facebook identifier
FullName

string

Facebook full name

UserGameCenterInfo

Name Type Description
GameCenterId

string

Gamecenter identifier

UserPsnInfo

Name Type Description
PsnAccountId

string

PlayStation ™️ Network account ID
PsnOnlineId

string

PlayStation ™️ Network online ID

UserSteamInfo

Name Type Description
SteamActivationStatus

TitleActivationStatus

what stage of game ownership the user is listed as being in, from Steam
SteamCountry

string

the country in which the player resides, from Steam data
SteamCurrency

Currency

currency type set in the user Steam account
SteamId

string

Steam identifier
SteamName

string

Steam display name

UserXboxInfo

Name Type Description
XboxUserId

string

XBox user ID
XboxUserSandbox

string

XBox user sandbox

ValueToDateModel

Name Type Description
Currency

string

ISO 4217 code of the currency used in the purchases
TotalValue

number

Total value of the purchases in a whole number of 1/100 monetary units. For example, 999 indicates nine dollars and ninety-nine cents when Currency is 'USD')
TotalValueAsDecimal

string

Total value of the purchases in a string representation of decimal monetary units. For example, '9.99' indicates nine dollars and ninety-nine cents when Currency is 'USD'.

Error Codes

Name Code
AccountNotFound 1001
ExpiredXboxLiveToken 1189
FacebookAPIError 1143
InvalidSignature 1273
InvalidSignatureTime 1324
InvalidXboxLiveToken 1188
PlayerSecretNotConfigured 1323
XboxInaccessible 1339
XboxServiceTooManyRequests 1505
XboxXASSExchangeFailure 1306