Understand the Session Registration Response
Besides the success boolean that is returned when registering a session, LootLocker also returns a host of other data upon successful session registration. This page will outline what to expect from a session registration response and what each individual response means. If you are not using the SDK, the response might look different.
This information can also be found in the Game API Reference Documentation

Session Registration Response

The standard session registration response looks like this.
1
{
2
public class SessionResponse : LootLockerResponse
3
{
4
public bool success { get; set; }
5
public string session_token { get; set; }
6
public int player_id { get; set; }
7
public bool seen_before { get; set; }
8
public bool check_grant_notifications { get; set; }
9
public bool check_deactivation_notifications { get; set; }
10
public int[] check_dlcs { get; set; }
11
public int xp { get; set; }
12
public int level { get; set; }
13
public Level_Thresholds level_thresholds { get; set; }
14
public int account_balance { get; set; }
15
}
16
17
public class Level_Thresholds
18
{
19
public int current { get; set; }
20
public bool current_is_prestige { get; set; }
21
public int next { get; set; }
22
public bool next_is_prestige { get; set; }
23
}
24
}
Copied!
success lets you know if the session registration was successful.
session_token is the token you need to make additional calls to LootLocker. To see how to send that along with further requests, see Sending Subsequent Requests.
player_id is the ID of the player on the platform the game is currently running on (steamId, PSN id, etc).
seen_before indicates if there is an existing profile on the backend for this player. If not, this parameter will be false, otherwise it will always be true.
check_grant_notification is for cases where the registration of a session might have triggered asynchronously granting assets to the player. For example, during DLC migration. If this value is true, you should issue a request for the player asset notification endpoint no earlier than 5 minutes after registering the session.
check_deactivation_notifications is for letting users know that one of their assets have been deactivated since they last logged in, and can't be used. See Player Asset Deactivation Notifications.
check_dlcs will include the IDs of the DLCs you should check with the first party platform to see if the player owns them. If the player owns any of them, issue a call to the Initiate DLC Migration endpoint.
xp will return the player's XP count from the Progression system. If nothing has been set up, this will be empty.
level will return the player's level, based on their XP from the Progression system. If nothing has been set up, this will be empty.
level_thresholds will display the current threshold necessary to complete the progression level, and the threshold necessary to complete the next progression level. It will also indicate if either of these levels are flagged as Prestige Levels.
account_balance displays the amount of currency the player has, set up through the Currency system.
More detailed explanations of all API responses can be found here.
Last modified 7mo ago