Server API
Home
LootLocker
Home
LootLocker
LootLocker
  1. Catalogs
  • Session
    • Session
      POST
    • Ping
      GET
  • Leaderboards
    • Schedules
      • Create
      • Delete
      • Get
    • Rewards
      • Create
      • Delete
    • Archives
      • Download
      • List
    • Manual Resets
      • Request Manual Reset
      • List Manual Resets
      • Get Manual Reset
      • Cancel Manual Reset
    • Get Leaderboard
      GET
    • List Leaderboards
      GET
    • Increment Score
      POST
    • Create Leaderboard
      POST
    • Update Leaderboard
      PUT
    • Delete Leaderboard
      DELETE
    • Submit Score
      POST
    • Get All Member Ranks
      GET
    • Get Score List
      GET
  • Assets
    • Simplified Asset Listing
      POST
    • List Contexts
      GET
    • 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 Character Inventory
    • Get Hero Inventory
    • Alter Player Inventory
    • Add Asset to Player Inventory
    • List Universal Assets
    • List Simplified Player Inventory
  • 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
      GET
    • Reward Grant
      POST
    • List Catalog Items By ID
      POST
  • Notifications
    • Send Notification to Player
  • Connected Accounts
    • List Providers For Players
  • Schemas
    • Catalogs
      • Catalog Asset Detail
      • Catalog Summary
      • Catalog Currency Detail
      • Apple App Store Listing
      • Google Play Store Listing
      • Steam Store Listing
      • Stripe Store Listing
      • Epic Games Store Listing
      • Playstation Store Listing
      • Price
      • Catalog Entry
      • Listings
      • Xbox Store Listing
    • Notifications
      • Types
    • Pagination
      • Offset Pagination
    • Metadata
      • Metadata Value
      • Metadata Entry
      • Metadata Action
      • Metadata Action Error
    • Wallets
      • Get Wallet Response
      • Untitled Schema
    • Assets
      • Asset v1
    • Leaderboards
      • ManualReset
    • ULID
    • TierRef
    • IdentityState
    • ProgressionSummary
    • ProgressionWithState
    • AwardResult
    • ErrorResponse
    • Cursor Pagination
  1. Catalogs

List Catalog Items By ID

POST
https://api.lootlocker.io/server/catalogs/inspired-ibex/v1/catalog/items
Look up catalog items by their catalog_listing_id values. Supports cross-catalog lookup (IDs are globally unique ULIDs), per-association entity detail inlining for groups, and conditional metadata inclusion. Returns partial success with per-ID errors on a 200 OK.

Request

Authorization
API Key
Add parameter in header
x-auth-token
Example:
x-auth-token: ********************
or
Body Params application/json

Examples

Responses

🟢200
application/json
Success (may contain errors array for partial failures).
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.lootlocker.io/server/catalogs/inspired-ibex/v1/catalog/items' \
--header 'x-auth-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ids": [
        "01J0000000000000000000000000"
    ],
    "includes": {
        "metadata": {
            "all": true
        }
    }
}'
Response Response Example
All IDs resolved successfully
{
    "items": [
        {
            "created_at": "2026-01-15T10:30:00Z",
            "listings": {},
            "entity_kind": "asset",
            "entity_name": "Sword of Testing",
            "prices": [
                {
                    "amount": "100",
                    "display_amount": "100",
                    "currency_code": "COIN",
                    "currency_name": "Coins",
                    "currency_id": "01J0000000000000000000000CUR"
                }
            ],
            "entity_id": "01J0000000000000000000000AST",
            "catalog_listing_id": "01J0000000000000000000000000",
            "purchasable": true,
            "non_refundable": false,
            "asset_detail": {
                "name": "Sword of Testing",
                "thumbnail": null,
                "variation_id": null,
                "rental_option_id": null,
                "legacy_id": 12345,
                "id": "01J0000000000000000000000AST",
                "catalog_listing_id": "01J0000000000000000000000000"
            },
            "metadata": [
                {
                    "key": "rarity",
                    "value": "epic",
                    "type": "string",
                    "tags": [],
                    "access": []
                }
            ]
        }
    ]
}
Modified at 2026-07-02 08:50:50
Previous
Reward Grant
Next
Send Notification to Player
Built with