Server API
HomeLootLocker
HomeLootLocker
LootLocker
  1. Player
  • Session
    • Session
      POST
    • Ping
      GET
  • Leaderboards
    • Schedules
      • Create
      • Delete
      • Get
    • Rewards
      • Create
      • Delete
    • Archives
      • Download
      • List
    • Get Leaderboard
      GET
    • Create Leaderboard
      POST
    • Update Leaderboard
      PUT
    • Delete Leaderboard
      DELETE
    • Submit Score
      POST
    • Get All Member Ranks
      GET
    • Get Score List
      GET
  • Assets
    • Get Assets
      GET
  • Asset Instances
    • Get All Storage To Asset Instance
      GET
    • Get Storage Pair by ID
      GET
    • Create Storage Pair on Asset Instance
      POST
    • Update Storage Pairs by Key on Instance
      PUT
    • Update Storage Pair by ID on Instance
      PUT
    • Delete Storage Pair by ID on Instance
      DELETE
  • Triggers
    • Invoke Trigger
      POST
  • Inventories
    • List Player Inventory
      GET
    • Get Character Inventory
      GET
    • Get Hero Inventory
      GET
    • Alter Player Inventory
      PATCH
    • Add Asset to Player Inventory
      POST
    • List Universal Assets
      GET
  • Loadouts
    • Get Player Loadout
    • Equip Asset for Player Loadout
    • Unequip Asset for Player Loadout
    • Get Character Loadout
    • Equip Asset for Character Loadout
    • Unequip Asset for Character Loadout
    • Get Hero Loadout
    • Equip Asset for Hero Loadout
    • Unequip Asset for Hero Loadout
  • Characters & Heroes
    • Get Player Characters
    • Get Player Heroes
  • Player Storage
    • Get Player Storage
    • Lookup keys for Multiple Players
    • Delete for Multiple Players
    • Set for Multiple Players
  • Player Files
    • List Files for Player
    • Get File By ID for Player
    • Delete File By ID for Player
    • Upload File For Player
  • Drop Tables
    • Compute and Lock Drop Table
    • Pick Drops
  • Loot Boxes
    • Inspect Loot Box
    • Open Loot Box
  • Player
    • Get Player Info By Game Session Tokens
      POST
    • Create Player
      POST
    • Lookup Player Names by IDs
      GET
  • Progressions
    • Tiers
      • Get Progression Tiers
      • Get Single Progression Tier By Step
    • Players
      • Get All Player Progressions
      • Get Player Progressions By ID
      • Add points to player progression
      • Subtract points from player progression
      • Reset player progression
      • Delete player progression
    • Characters
      • Get All Character Progressions
      • Get Character Progressions By ID
      • Add points to Character progression
      • Subtract points from Character progression
      • Reset Character progression
      • Delete Character progression
    • Asset Instances
      • Get All Asset Instance Progressions
      • Get Asset Instance Progressions By ID
      • Add points to Asset Instance progression
      • Subtract points from Asset Instance progression
      • Reset Asset Instance progression
      • Delete Asset Instance progression
    • Get All Progressions
    • Get Progression By Key
  • Balances
    • Create Wallet Modifiers
    • Credit Balance
    • Debit Balance
    • List Balances
    • Create New Wallet
    • Get Wallet
    • Get Wallet for Holder
  • Currency
    • List Currencies
  • Friends
    • List Friends
  • Metadata
    • Metadata Actions
    • List Metadata
    • List Multisource Metadata
  • Catalogs
    • List Catalog Items By Key
  • Notifications
    • Send Notification to Player
  1. Player

Create Player

POST
/server/player
This endpoint works by creating an unverified session for a player with the platform and identifier from the input. No verification is performed by LootLocker. If a player already exists, the player integer ID and ULID will be returned. If a player doesn't exist yet, one will be created before returning the same integer ID and ULID.
If the player identifier isn't normally sent in the Game API session endpoint, you should ensure that you resolve it correctly from the original platform (eg steam) before calling this endpoint.
The following platforms are supported:
PlatformValue
Steamsteam
PlayStation / PSNpsn
Sign in with Appleapple_sign_in
Apple Game Centerapple_game_center
Apple App Storeapple_app_store
Google Sign Ingoogle_sign_in
Google Play Storegoogle_play_store
Xboxxbox_one
Nintendo Switchnintendo_switch
Amazon Lunaamazon_luna
White Label Loginwhite_label_login
Guestguest
Epic Gamesepic_games
Metameta
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.lootlocker.io/server/player' \
--header 'Content-Type: application/json' \
--header 'x-auth-token;' \
--data-raw '{
    "platform": "steam",
    "player_identifier": "string"
}'
Response Response Example
200 - Success
{
  "player_id": 9,
  "player_ulid": "01JMY7BEXA4GVWF513ANKK4383"
}

Request

Authorization
API Key
Add parameter in header
x-auth-token
Example:
x-auth-token: ********************
Body Params application/json
platform
string 
required
Examples:
steampsnnintendo_switch
player_identifier
string 
required
Examples

Responses

🟢200OK
application/json
Body
player_id
integer <uint64>
required
player_ulid
string <uuid>
required
🟠403Platform Not Enabled
Modified at 2025-04-07 14:01:49
Previous
Get Player Info By Game Session Tokens
Next
Lookup Player Names by IDs
Built with