Get leaderboard rankings

GET

https://api.eu-west-1.aworld.cloud/app/v1/runtime-leaderboards/{runtimeLeaderboardId}/rankings

Retrieves the current rankings for a runtime leaderboard. Returns top users ordered by score. Supports pagination.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Leaderboard rankings retrieved successfully.

Body

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.eu-west-1.aworld.cloud/app/v1/runtime-leaderboards//rankings?limit&offset' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "items": [
        {
            "rank": 1,
            "userId": "string",
            "nickname": "string",
            "profileImageUrl": "http://example.com",
            "score": 0
        }
    ],
    "totalCount": 0,
    "currentUserRank": {
        "rank": 1,
        "userId": "string",
        "nickname": "string",
        "profileImageUrl": "http://example.com",
        "score": 0
    },
    "leaderboard": {
        "runtimeLeaderboardId": "string",
        "name": "string",
        "description": "string",
        "displayTopN": 1,
        "showUserScore": true
    }
}

Modified at 2026-02-10 10:38:01

Get a runtime leaderboard by ID

Get current user's ranking