Bulk Create Leaderboards

POST

https://api.lootlocker.io/admin/game/{game_id}/leaderboards/bulk

Create up to 50 leaderboards in a single request. Each item is processed independently; validation errors on any item reject the entire batch with an index, while per-item database errors (e.g. duplicate keys) appear in the per-result output and processing continues.

Request

Authorization

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bulk create completed. Check each result item for per-leaderboard success or failure.

Bodyapplication/json

🟠400

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.lootlocker.io/admin/game//leaderboards/bulk' \
--header 'Content-Type: application/json' \
--data '{
    "leaderboards": [
        {
            "name": "Season 1 Leaderboard",
            "key": "season_1",
            "direction_method": "descending",
            "type": "player",
            "enable_game_api_writes": true,
            "overwrite_score_on_submit": false,
            "has_metadata": false
        },
        {
            "name": "Season 1 Generic",
            "key": "season_1_generic",
            "direction_method": "ascending",
            "type": "generic",
            "enable_game_api_writes": false,
            "overwrite_score_on_submit": false,
            "has_metadata": false
        }
    ]
}'

Response Example

200 - Success

{
    "results": [
        {
            "id": 42,
            "name": "Season 1 Leaderboard",
            "key": "season_1"
        },
        {
            "id": 0,
            "name": "Season 1 Generic",
            "key": "season_1_generic",
            "error": "leaderboard with key already exists"
        }
    ]
}

Modified at 2026-07-14 07:05:44

Delete Leaderboard Member On All Boards

Get Files to Game