Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

[GET] /community/leaderboard/GetPersonalStat

Example request

Returns a player’s profile information and their ranking statistics across all leaderboards they have participated in.

Request

parametertypevaluecomments
titlestr/enumage1, age2, age3, age4
profile_namesarray[str]e.g. [“/steam/<steam_id>”]
aliasesarray[str][BlackRock]

Response

AoE2:DE

The response pairs statGroups (player profile) with leaderboardStats (one entry per leaderboard the player has played on).

{
    "result": {
        "code": 0,
        "message": "SUCCESS"
    },
    "statGroups": [
        {
            "id": 200,
            "name": "",
            "type": 1,
            "members": [
                {
                    "profile_id": 196240,
                    "name": "/steam/76561197984749679",
                    "alias": "GL.TheViper",
                    "personal_statgroup_id": 200,
                    "xp": 3091,
                    "level": 2,
                    "leaderboardregion_id": 0,
                    "country": "de"
                }
            ]
        }
    ],
    "leaderboardStats": [
        {
            "statgroup_id": 200,
            "leaderboard_id": 3,
            "wins": 910,
            "losses": 477,
            "streak": 5,
            "disputes": 0,
            "drops": 4,
            "rank": 3,
            "ranktotal": 39023,
            "ranklevel": 1,
            "rating": 2602,
            "regionrank": 3,
            "regionranktotal": 15933,
            "lastmatchdate": 1664555924
        },
        {
            "statgroup_id": 200,
            "leaderboard_id": 4,
            "wins": 119,
            "losses": 35,
            "streak": -1,
            "disputes": 0,
            "drops": 10,
            "rank": -1,
            "ranktotal": 62599,
            "ranklevel": 0,
            "rating": 1443,
            "regionrank": -1,
            "regionranktotal": 25154,
            "lastmatchdate": 1661468788
        }
        // ... one entry per leaderboard the player has participated in
    ]
}

statGroups[].members[] fields

fieldtypedescription
profile_idintUnique player profile identifier
namestringPlatform-specific identity (e.g. /steam/<steam_id>)
aliasstringPlayer display name
personal_statgroup_idintThe player’s personal stat group ID
xpintExperience points
levelintPlayer level
leaderboardregion_idintRegion ID (see GetAvailableLeaderboards)
countrystringISO 3166-1 alpha-2 country code

leaderboardStats[] fields

fieldtypedescription
statgroup_idintReferences the statGroups entry by id
leaderboard_idintLeaderboard this stat belongs to
winsintTotal wins
lossesintTotal losses
streakintCurrent win/loss streak (positive = wins, negative = losses)
disputesintNumber of disputed matches
dropsintNumber of disconnects
rankintCurrent rank position (-1 = unranked)
ranktotalintTotal number of ranked players on this leaderboard
ranklevelintRank tier/level (0 = unranked, 1 = ranked)
ratingintElo rating
regionrankintRank within the player’s region (-1 = unranked)
regionranktotalintTotal ranked players in the region (-1 = unavailable)
lastmatchdateintUnix timestamp of the last match played