Game API
HomeLootLocker
HomeLootLocker
LootLocker
  1. Notifications
  • 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
    • 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
      POST
    • Sign In
      POST
    • Request Verification
      POST
    • Request Reset Password
      POST
    • Verify Session
      POST
  • 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
      GET
    • Read Notifications
      PUT
    • Read All Notifications
      PUT
  • 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
    • Submit Score
    • Get Member Rank
    • Get By List of Members
    • List Leaderboards
    • Get Leaderboard Details
    • List Historical Leaderboard Data
    • Get Historical Leaderboard Data
  • 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. Notifications

List Notifications

GET
https://api.lootlocker.com/game/notifications/v1
notifications
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.lootlocker.com/game/notifications/v1?per_page=10&page=1&custom=true' \
--header 'x-session-token;'
Response Response Example

Request

Authorization
API Key
Add parameter in header
x-session-token
Example:
x-session-token: ********************
or
Query Params
per_page
integer <uint64>
optional
>= 1
Example:
10
page
integer <uint64>
optional
>= 1
Example:
1
priority
enum<string> 
optional
Allowed values:
lowmediumhighemergency
Default:
medium
Example:
medium
notification_type
enum<string> 
optional
Allowed value:
pull.reward.acquired
Example:
pull.reward.acquired
read
boolean 
optional
Example:
true
source
enum<string> 
optional
Allowed values:
purchasing.apple_app_storepurchasing.google_play_storepurchasing.steam_storepurchasing.lootlockertriggerslootlocker.consolelootlocker.server_api
Example:
purchasing.apple_app_store
custom
boolean 
optional
Optional. true If you want to restrict notifications to custom ones, false to view only automated notifications.
Example:
true

Responses

🟢200OK
application/json
Body
notifications
array [object {11}]  | null 
required
created_at
string <date-time> | null 
required
The time that this notification was created
expiration_date
string <date-time>
required
At what time that this notification expires
read_at
string <date-time> | null 
optional
The time that this notification was acknowledged. Will be empty if the notification has not been acknowledged
notification_type
string 
required
The type of this notification
Match pattern:
^[a-z_-]+\.[a-z_-]+\.[a-z_-]+$
priority
string 
required
The priority of this notification (default: medium)
source
enum<string> 
required
The originating source of this notification (for example, did it originate from a purchase, a leaderboard reward, or a trigger?)
Allowed values:
purchasing.apple_app_storepurchasing.google_play_storepurchasing.steam_storepurchasing.playstation_networkpurchasing.nintendo_eshoppurchasing.lootlockerpurchasing.stripe_storetriggerslootlocker.consolelootlocker.server_apilootlocker.admin_api
content
object 
required
id
#/definitions/3587649
required
The id of the notification, use this when acknowledging and dismissing
Could not resolve '#/definitions/3587649'
player_id
#/definitions/3587649
required
The id of the player that this notification is for
Could not resolve '#/definitions/3587649'
read
boolean 
required
Whether this notification has been acknowledged or not
custom
boolean 
required
Will be set to true if it's a custom notification (not one sent by lootlocker)
pagination
object (Offset Pagination) 
required
errors
array [object {2}]  | null 
required
If the values provided don't allow for pagination to happen, errors will be indicated within this array.
per_page
integer <uint64>
required
>= 0
offset
integer <uint64>
required
How far you are within the total set of records.
>= 0
total
integer <uint64>
required
How many items total were found.
>= 0
last_page
integer <uint64>
required
>= 0
current_page
integer <uint64>
required
>= 0
next_page
integer <uint64> | null 
required
>= 0
prev_page
integer <uint64> | null 
required
>= 0
Modified at 2025-05-16 12:47:01
Previous
Notifications
Next
Read Notifications
Built with