User position

Description

Use this endpoint to retrieve an user's position in a Scoreboard.

Endpoint

GET https://api.gamerank.io/scoreboard/{userid}/position

Request URL Parameters

Parameter	Description
userid	User unique identifier. Alpha-numerical ASCII characters only

Example

GET https://api.gamerank.io/scoreboard/82911/position

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 scoreboard
entry	int	Player's best score in the scoreboard
creation_time	millisecond timestamp	UTC timestamp (in millisecond) at which the player best score has been submitted

{
  "userid": "82911",
  "username": "Bob",
  "position": 43,
  "entry": 328716,
  "creation_time": 1730026754899
}

HTTP status code

HTTP status	Reason(s)
200	• OK
400	• Invalid user ID format
404	• Unknown API key / scoreboard • Unknown user
500	• Server Error, please contact support@gamerank.io