User position
Description
Use this endpoint to retrieve an user's position in a leaderboard.
Endpoint
GET https://api.gamerank.io/leaderboard/score/user/position/{userid}
Request URL Parameters
| Parameter | Description |
|---|---|
| userid | User unique identifier. Alpha-numerical ASCII characters only. |
Example
GET https://api.gamerank.io/leaderboard/score/user/position/3937
Response JSON body
| Field | Type | Description |
|---|---|---|
| userid | string | User id used to store this score |
| username | string | Displayable user name |
| position | int | Position of the user in the leaderboard |
| score | int | Player's best score in the leaderboard |
| score_creation_time | millisecond timestamp | UTC timestamp in millisecond at which the player did their best score |
{
"userid": "82911",
"username": "Bob",
"position": 43,
"score": 328716,
"score_best_time": 1730026754899
}
HTTP status code
| HTTP status | Reason(s) |
|---|---|
| 200 | • OK |
| 400 | • Invalid user ID format |
| 404 | • Unknown API key / leaderboard • Unknown user |
| 500 | • Server Error, please contact support@gamerank.io |