Authentication - Authenticate Session Ticket

Service:

Server

API Version:

241122

Validated a client's session ticket, and if successful, returns details for that user

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

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
SessionTicket	True	string	Session ticket as issued by a PlayFab client login API.

Responses

Name	Type	Description
200 OK	AuthenticateSessionTicketResult
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
ApiErrorWrapper	The basic wrapper around every failed API response
AuthenticateSessionTicketRequest	Note that data returned may be Personally Identifying Information (PII), such as email address, and so care should be taken in how this data is stored and managed. Since this call will always return the relevant information for users who have accessed the title, the recommendation is to not store this data locally.
AuthenticateSessionTicketResult
Currency
EntityKey	Combined entity type and ID structure which uniquely identifies a single entity.
TitleActivationStatus
UserAccountInfo
UserAndroidDeviceInfo
UserAppleIdInfo
UserCustomIdInfo
UserFacebookInfo
UserFacebookInstantGamesIdInfo
UserGameCenterInfo
UserGoogleInfo
UserGooglePlayGamesInfo
UserIosDeviceInfo
UserKongregateInfo
UserNintendoSwitchAccountIdInfo
UserNintendoSwitchDeviceIdInfo
UserOpenIdInfo
UserOrigination
UserPrivateAccountInfo
UserPsnInfo
UserServerCustomIdInfo
UserSteamInfo
UserTitleInfo
UserTwitchInfo
UserXboxInfo

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

AuthenticateSessionTicketRequest

Note that data returned may be Personally Identifying Information (PII), such as email address, and so care should be taken in how this data is stored and managed. Since this call will always return the relevant information for users who have accessed the title, the recommendation is to not store this data locally.

Name	Type	Description
SessionTicket	string	Session ticket as issued by a PlayFab client login API.

AuthenticateSessionTicketResult

Name	Type	Description
IsSessionTicketExpired	boolean	Indicates if token was expired at request time.
UserInfo	UserAccountInfo	Account info for the user whose session ticket was supplied.

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

EntityKey

Combined entity type and ID structure which uniquely identifies a single entity.

Name	Type	Description
Id	string	Unique ID of the entity.
Type	string	Entity type. See https://docs.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types

TitleActivationStatus

Name	Type	Description
ActivatedSteam	string
ActivatedTitleKey	string
None	string
PendingSteam	string
RevokedSteam	string

UserAccountInfo

Name	Type	Description
AndroidDeviceInfo	UserAndroidDeviceInfo	User Android device information, if an Android device has been linked
AppleAccountInfo	UserAppleIdInfo	Sign in with Apple account information, if an Apple account has been linked
Created	string	Timestamp indicating when the user account was created
CustomIdInfo	UserCustomIdInfo	Custom ID information, if a custom ID has been assigned
FacebookInfo	UserFacebookInfo	User Facebook information, if a Facebook account has been linked
FacebookInstantGamesIdInfo	UserFacebookInstantGamesIdInfo	Facebook Instant Games account information, if a Facebook Instant Games account has been linked
GameCenterInfo	UserGameCenterInfo	User Gamecenter information, if a Gamecenter account has been linked
GoogleInfo	UserGoogleInfo	User Google account information, if a Google account has been linked
GooglePlayGamesInfo	UserGooglePlayGamesInfo	User Google Play Games account information, if a Google Play Games account has been linked
IosDeviceInfo	UserIosDeviceInfo	User iOS device information, if an iOS device has been linked
KongregateInfo	UserKongregateInfo	User Kongregate account information, if a Kongregate account has been linked
NintendoSwitchAccountInfo	UserNintendoSwitchAccountIdInfo	Nintendo Switch account information, if a Nintendo Switch account has been linked
NintendoSwitchDeviceIdInfo	UserNintendoSwitchDeviceIdInfo	Nintendo Switch device information, if a Nintendo Switch device has been linked
OpenIdInfo	UserOpenIdInfo[]	OpenID Connect information, if any OpenID Connect accounts have been linked
PlayFabId	string	Unique identifier for the user account
PrivateInfo	UserPrivateAccountInfo	Personal information for the user which is considered more sensitive
PsnInfo	UserPsnInfo	User PlayStation ™️ Network account information, if a PlayStation ™️ Network account has been linked
ServerCustomIdInfo	UserServerCustomIdInfo	Server Custom ID information, if a server custom ID has been assigned
SteamInfo	UserSteamInfo	User Steam information, if a Steam account has been linked
TitleInfo	UserTitleInfo	Title-specific information for the user account
TwitchInfo	UserTwitchInfo	User Twitch account information, if a Twitch account has been linked
Username	string	User account name in the PlayFab service
XboxInfo	UserXboxInfo	User XBox account information, if a XBox account has been linked

UserAndroidDeviceInfo

Name	Type	Description
AndroidDeviceId	string	Android device ID

UserAppleIdInfo

Name	Type	Description
AppleSubjectId	string	Apple subject ID

UserCustomIdInfo

Name	Type	Description
CustomId	string	Custom ID

UserFacebookInfo

Name	Type	Description
FacebookId	string	Facebook identifier
FullName	string	Facebook full name

UserFacebookInstantGamesIdInfo

Name	Type	Description
FacebookInstantGamesId	string	Facebook Instant Games ID

UserGameCenterInfo

Name	Type	Description
GameCenterId	string	Gamecenter identifier

UserGoogleInfo

Name	Type	Description
GoogleEmail	string	Email address of the Google account
GoogleGender	string	Gender information of the Google account
GoogleId	string	Google ID
GoogleLocale	string	Locale of the Google account
GoogleName	string	Name of the Google account user

UserGooglePlayGamesInfo

Name	Type	Description
GooglePlayGamesPlayerAvatarImageUrl	string	Avatar image url of the Google Play Games player
GooglePlayGamesPlayerDisplayName	string	Display name of the Google Play Games player
GooglePlayGamesPlayerId	string	Google Play Games player ID

UserIosDeviceInfo

Name	Type	Description
IosDeviceId	string	iOS device ID

UserKongregateInfo

Name	Type	Description
KongregateId	string	Kongregate ID
KongregateName	string	Kongregate Username

UserNintendoSwitchAccountIdInfo

Name	Type	Description
NintendoSwitchAccountSubjectId	string	Nintendo Switch account subject ID

UserNintendoSwitchDeviceIdInfo

Name	Type	Description
NintendoSwitchDeviceId	string	Nintendo Switch Device ID

UserOpenIdInfo

Name	Type	Description
ConnectionId	string	OpenID Connection ID
Issuer	string	OpenID Issuer
Subject	string	OpenID Subject

UserOrigination

Name	Type	Description
Amazon	string
Android	string
Apple	string
CustomId	string
Facebook	string
FacebookInstantGamesId	string
GameCenter	string
GamersFirst	string
Google	string
GooglePlayGames	string
IOS	string
King	string
Kongregate	string
LoadTest	string
NintendoSwitchAccount	string
NintendoSwitchDeviceId	string
OpenIdConnect	string
Organic	string
PSN	string
Parse	string
ServerCustomId	string
Steam	string
Twitch	string
Unknown	string
XboxLive	string
XboxMobileStore	string

UserPrivateAccountInfo

Name	Type	Description
Email	string	user email address

UserPsnInfo

Name	Type	Description
PsnAccountId	string	PlayStation ™️ Network account ID
PsnOnlineId	string	PlayStation ™️ Network online ID

UserServerCustomIdInfo

Name	Type	Description
CustomId	string	Custom 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

UserTitleInfo

Name	Type	Description
AvatarUrl	string	URL to the player's avatar.
Created	string	timestamp indicating when the user was first associated with this game (this can differ significantly from when the user first registered with PlayFab)
DisplayName	string	name of the user, as it is displayed in-game
FirstLogin	string	timestamp indicating when the user first signed into this game (this can differ from the Created timestamp, as other events, such as issuing a beta key to the user, can associate the title to the user)
LastLogin	string	timestamp for the last user login for this title
Origination	UserOrigination	source by which the user first joined the game, if known
TitlePlayerAccount	EntityKey	Title player account entity for this user
isBanned	boolean	boolean indicating whether or not the user is currently banned for a title

UserTwitchInfo

Name	Type	Description
TwitchId	string	Twitch ID
TwitchUserName	string	Twitch Username

UserXboxInfo

Name	Type	Description
XboxUserId	string	XBox user ID
XboxUserSandbox	string	XBox user sandbox

Error Codes

Name	Code
InvalidSessionTicket	1100