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: ********************

Body Params application/json

Examples

Responses

🟢200

application/json

Success (may contain errors array for partial failures).

Bodyapplication/json

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 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

Reward Grant

Send Notification to Player