Game API
HomeLootLocker
HomeLootLocker
LootLocker
  1. Leaderboards
  • Game API
  • Authentication
    • Guest Session
      POST
    • White Label Session
      POST
    • Steam Session
      POST
    • Epic Games Session
      POST
    • Apple Sign In Session
      POST
    • Apple Game Center Session
      POST
    • Google Session
      POST
    • Google Play Games Session
      POST
    • Nintendo Switch Session
      POST
    • Xbox Session
      POST
    • Meta/Oculus Session
      POST
    • PSN Player Verification
      POST
    • Steam/PSN Session
      POST
    • End Session
      DELETE
    • Steam Player Verification
      POST
  • Unified Player Accounts
    • Connected Accounts
      • List Connected Accounts
      • Connect Google Account
      • Connect Twitch Account
      • Connect Apple Account
      • Attach Provider
      • Transfer Providers
      • Unlink Platform Provider
    • Begin Remote Session Login Lease
      POST
    • Begin Remote Session Link Lease
      POST
    • Poll Remote Session Lease
      POST
    • Refresh Remote Session
      POST
  • White Label Login
    • Sign Up
    • Sign In
    • Request Verification
    • Request Reset Password
    • Verify Session
  • Players
    • Files
    • Player Storage
      • Get Player Storage
      • Get Player Storage Single Item
      • Get Player Public Storage
      • Update Player Storage
      • Lookup Public Player Storage
      • Delete Player Storage Item
    • Get Info From Session
    • List Multiple Players Info
    • Lookup Player Names by IDS
    • Get Players Active Name
    • Set Player Name
    • Migrate DLCs
    • Get Migrated DLCs
    • Set Player Profile Private
    • Set Player Profile Public
    • Get Other Players Loadout for Default Character
    • Get Players Loadout for Default Character
    • Delete Player
    • Submit XP
    • Get Other Player Info
    • Get Player Info
    • Get Multiple Other Players XP And Level
  • Notifications
    • List Notifications
    • Read Notifications
    • Read All Notifications
  • Commerce
    • Currency
      • Get Currency By Code
      • List Currencies
      • List Denominations By Currency
    • Purchasing
      • Stores
        • Google Play Store
          • Google Play Player Product Purchase
          • Google Play Character Product Purchase
        • Apple App Store
          • Apple App Store - Player Purchase
          • Apple App Store - Character Purchase
        • Steam
          • Steam - Begin Purchase
          • Steam - Query Transaction
          • Steam - Finalise Transaction
      • Purchase - In Game Only
      • Get Player Balance
      • Purchase - Get Status
      • Get Order Details
      • Purchase - Soft Currency Spend
      • Purchase - Steam Hard Currency
      • Purchase - Android
      • Purchase - iOS
    • Balances
      • Credit Balance
      • Debit Balance
      • List Balances
      • Get Wallet
      • Get Wallet for Holder
      • Create New Wallet
    • Catalogs
      • List Catalogs For Game
      • List Catalog Items By Key
  • Entitlements
    • List Entitlements
    • Get Single Entitlement
  • Leaderboards
    • Get Score List
      GET
    • Submit Score
      POST
    • Get Member Rank
      GET
    • Get By List of Members
      POST
    • List Leaderboards
      GET
    • Get Leaderboard Details
      GET
    • List Historical Leaderboard Data
      GET
    • Get Historical Leaderboard Data
      GET
  • Characters & Heroes
    • Characters
      • List Equippable Contexts to Default Character
      • List Equippable Contexts to Character By ID
      • Update Character
      • List Character Types
      • List Characters
      • Create Character
      • Get Loadout For All Player Characters
      • Get Loadout For Player Characters By Platform ID
      • Equip Asset To Character
      • Unequip Asset To Character
      • Equip Asset To Default Character
      • Unequip Asset To Default Character
    • Heroes
      • Get Game Heroes
      • Create Player Hero
      • List Player Heroes
      • Get Player Hero
      • Update Player Hero
      • Delete Player Hero
      • List Player Hero Inventory
      • Get Default Player Hero By SteamID64
      • List Player Heroes By SteamID64
      • List Player Heros Loadout By ID
      • Get Player Hero Loadout
      • Equip Asset to Hero
      • Unequip Asset from Hero
  • Assets
    • Drop Tables
      • Compute and Lock Drop Table
      • Pick Drops
    • List Contexts
    • Get Assets Stream
    • Get Assets List
    • Get Assets List By Asset IDs
    • List Favourite Assets
    • Unfavourite Asset
    • Favourite Asset
  • Asset Instances
    • Storage
      • Stream All Instance Storage To Player
      • Get Key Value for Asset Instance and Key Value Pair ID
      • List Key Value Sets for Asset Instance
      • Create Key Value Pair
      • Update Item Storage By Keys
      • Update Item Storage By ID
      • Delete Item Storage By ID
    • Loot Box
      • Inspect Loot Box
      • Open Loot Box
    • List Universal Assets
    • List Player Inventory
    • Stream Player Inventory
    • Get Asset Grant Notifications
    • Activate Rental Asset
    • Delete asset from player's inventory
    • Grant asset to player
  • Triggers
    • Call
    • Execute Trigger
    • List Triggers For Player
  • Progressions
    • Tiers
      • Get Progression Tiers
      • Get Single Progression Tier By Step
    • Players
      • Get All Player Progressions
      • Get All Player Progressions By Player ULID
      • Get Player Progressions By Key
      • Get Player Progressions By Key and Player ULID
      • 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 Key
      • 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 Key
      • Add points to an Asset Instance progression
      • Subtract points from an Asset Instance progression
      • Reset Asset Instance progression
      • Delete Asset Instance progression
    • Get All Progressions
    • Get Progression By Key
  • Messages
    • List Messages
  • Friends
    • Followers
      • List
      • Follow
      • Unfollow
    • List Friends
    • List Incoming Friend Requests
    • List Outgoing Friend Requests
    • Send Friend Request
    • Cancel Outgoing Friend Request
    • Accept Friend Request
    • Decline Friend Request
    • Delete Friend
    • List Blocked Players
    • Block Player
    • Unblock Player
  • Feedback
    • Category
      • List
    • Moderation Reporting
      • [Legacy] Report Player
      • [Legacy] Report Asset
      • [Legacy] Get Player Report Reasons
      • [Legacy] Get Asset Report Reasons
      • [Legacy] Get Asset Report Types
      • Get Removed UGC for Player
    • Create
  • Metadata
    • List Metadata
    • Metadata Operations
    • List Multisource Metadata
  • User Generated Content (UGC)
    • Asset Candidates
      • Get Asset Candidate
      • List Asset Candidates
      • Create Asset Candidate
      • Add File to Asset Candidate
      • Update Asset Candidate
      • Delete Asset Candidate
  • Game
    • Get Game Info
    • Ping
  • Collectables
    • Collect Collectable Item
    • List Collectables
  • Missions
    • Get Mission
    • List Missions
    • Start Mission
    • Finish Mission
  • Broadcasts
  1. Leaderboards

Submit Score

POST
https://api.lootlocker.com/game/leaderboards/{leaderboard_id}/submit
Submit a score to the specified leaderboard
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api.lootlocker.com/game/leaderboards//submit' \
--header 'Content-Type: application/json' \
--header 'x-session-token;' \
--data-raw '{
    // "member_id": "{{$randomFirstName}}",
    "score": 12312313
}'
Response Response Example
{
    "metadata": "string",
    "member_id": "string",
    "rank": 0,
    "score": 0
}

Request

Authorization
API Key
Add parameter in header
x-session-token
Example:
x-session-token: ********************
or
Path Params
leaderboard_id
string 
required
The leaderboard key OR integer id of the leaderboard you wish to submit scores to
Example:
{{leaderboard_id}}
Header Params
x-session-token
string 
required
Example:
{{session_token}}
Body Params application/json
Request object containing information on the score to submit
member_id
string 
required
The id of the member to submit scores for. If the leaderboard is a player type leaderboard this should be the player id, if the leaderboard is a generic type leaderboard then this can be any string.
score
integer 
required
The score to submit
metadata
string  | null 
optional
Metadata (if metadata is enabled for the leaderboard) to set for the submitted score
Examples

Responses

🟢200OK
application/json
Body
Response object containing information about the successfully submitted score
metadata
string  | null 
required
Metadata (if any was set and it is enabled for this leaderboard) for the leaderboard entry
member_id
string 
required
The member id that was set for this leaderboard entry
rank
integer 
required
The rank that the submitted score reached
score
integer 
required
The score as submitted
Modified at 2025-05-22 11:52:31
Previous
Get Score List
Next
Get Member Rank
Built with