Server API
HomeLootLocker
HomeLootLocker
LootLocker
  1. Inventories
  • 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
  • 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
    • Create Player
    • Lookup Player Names by IDs
  • 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. Inventories

Add Asset to Player Inventory

POST
/server/player/{player_id}/inventory
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.lootlocker.io/server/player/363/inventory' \
--header 'LL-Version: 2021-03-01' \
--header 'Content-Type: application/json' \
--header 'x-auth-token;' \
--data-raw '{
    "asset_id": 64,
    "asset_variation_id": null
}'
Response Response Example
{
  "items": [
    {
      "id": 1,
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
      "ulid": "01J8J4FJG869W5Q19FSDT8D3AC",
      "name": "string",
      "active": true,
      "purchasable": true,
      "price": 0,
      "sales_price": 1,
      "display_price": "string",
      "context": "string",
      "context_id": 1,
      "character_classes": [
        1
      ],
      "unlocks_context": "string",
      "detachable": true,
      "updated": "string",
      "marked_new": "string",
      "default_variation_id": 1,
      "default_loadouts": {
        "<user supplied loadout name>": true
      },
      "description": "string",
      "links": [
        {
          "<user supplied simple name>": "string"
        }
      ],
      "storage": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "rarity": {
        "name": "string",
        "short_name": "string",
        "color": "string"
      },
      "popular": true,
      "popularity_score": 1,
      "package_contents": [
        {
          "asset": {}
        }
      ],
      "unique_instance": true,
      "external_identifiers": {
        "psn": {
          "entitlement_id": "string",
          "sku_id": "string",
          "product_id": "string"
        },
        "apple_app_store": {
          "product_id": "string"
        },
        "google_play": {
          "product_id": "string"
        }
      },
      "rental_options": [
        {
          "id": 0,
          "name": "string",
          "duration": 0,
          "price": 0,
          "sales_price": 0,
          "links": [
            {
              "<user supplied simple name>": "string"
            }
          ]
        }
      ],
      "filters": [
        {
          "value": "string",
          "name": "string"
        }
      ],
      "files": [
        {
          "id": 1,
          "name": "string",
          "duration": 1,
          "price": 1,
          "sales_price": 1,
          "links": [
            {
              "<user supplied simple name>": "string"
            }
          ]
        }
      ],
      "data_entities": [
        "string"
      ],
      "hero_equip_exceptions": [
        {
          "can_equip": true,
          "hero_id": 0,
          "hero_name": "string"
        }
      ],
      "asset_candidate": 1,
      "drop_table_max_picks": 1,
      "variations": [
        {
          "id": 1,
          "name": "string",
          "primary_color": "string",
          "secondary_color": "string",
          "links": [
            {
              "<user supplied simple name>": "string"
            }
          ]
        }
      ],
      "featured": true,
      "context_locked": true,
      "initially_purchasable": true
    }
  ]
}

Request

Authorization
API Key
Add parameter in header
x-auth-token
Example:
x-auth-token: ********************
Path Params
player_id
string 
required
Example:
363
Header Params
LL-Version
string 
required
Example:
2021-03-01
Body Params application/json
asset_id
integer 
required
asset_variation_id
null 
required
Examples

Responses

🟢200OK
application/json
Body
items
array[object (Asset v1) {38}] 
required
id
integer <uint64> | null 
required
>= 1
uuid
string <uuid> | null 
required
ulid
string  | null 
required
Example:
01J8J4FJG869W5Q19FSDT8D3AC
name
string  | null 
required
active
boolean  | null 
required
purchasable
boolean  | null 
required
price
integer <uint64> | null 
deprecated
Price for the old economy system
sales_price
integer <uint64> | null 
deprecated
Sales price for the old economy system
>= 1
display_price
string  | null 
deprecated
Display price for the old economy system
context
string  | null 
required
Name of the context this asset belongs to
context_id
integer <uint64> | null 
required
ID of the context this asset belongs to
>= 1
character_classes
array[integer <uint64> | null] | null 
required
unlocks_context
string 
required
Name of the context that will be unlocked via ownership of this asset.
detachable
boolean  | null 
required
Can the asset be detached from a players loadout?
updated
string  | null 
required
When this asset was last updated
marked_new
string  | null 
required
Used to allow game UIs to show a new badge on items even if they aren't technically new
default_variation_id
integer <uint64> | null 
deprecated
>= 1
default_loadouts
object  | null 
required
A list of names of character names with a boolean value for if the asset is in said characters default loadout (dynamic keys)
description
string  | null 
required
Free text description of the asset
links
array [object {1}] 
required
An object of external references such as images (dynamic keys)
storage
array [object {2}]  | null 
required
A key/value storage
rarity
object  | null 
required
popular
boolean  | null 
deprecated
Is this asset popular with players?
popularity_score
integer <uint64> | null 
deprecated
The raw number used to calculate if the asset is popular
>= 1
package_contents
array [object {1}]  | null 
deprecated
unique_instance
boolean  | null 
required
If true, the player can only own one of this asset
external_identifiers
object  | null 
required
rental_options
array [object {6}] 
required
filters
array [object {2}]  | null 
required
files
array [object {6}]  | null 
required
data_entities
array[string | null] | null 
required
hero_equip_exceptions
array [object {3}]  | null 
required
asset_candidate
integer <uint64>
required
Set to the ID of the asset candidate if this is an asset derived from an asset candidate
>= 1
drop_table_max_picks
integer <uint64>
required
>= 1
variations
array [object {5}]  | null 
required
featured
boolean  | null 
required
context_locked
boolean  | null 
required
initially_purchasable
boolean  | null 
required
Modified at 2025-04-07 14:11:20
Previous
Alter Player Inventory
Next
List Universal Assets
Built with