User position

Description

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

Endpoint

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

Request URL Parameters

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

Example

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

Response JSON body

Field	Type	Description
userid	string	User id used to store this time
username	string	Displayable user name
position	int	Position of the user in the leaderboard
entry	int	Player's best score in the leaderboard
creation_time	millisecond timestamp	UTC timestamp (in millisecond) at which the player did their best score

{
  "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 / timeboard • Unknown user
500	• Server Error, please contact support@gamerank.io