User top times

Description

Use this endpoint to retrieve a list of top times for an user.

Endpoint

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

Request URL Parameters

Parameter	Description
userid	User unique identifier. Alpha-numerical ASCII characters only.
count	How many times to retrieve.

Example

GET https://api.gamerank.io/timeboard/282915/top/2

Response JSON body

Field	Type	Description
userid	string	User id used to store this time
username	string	Displayable user name
creation_time	millisecond timestamp	UTC timestamp (in millisecond) when this top time has been submitted
entry	int	Submitted time (in millisecond)

[
  {
    "userid": "282915",
    "username": "Alice",
    "creation_time": 1728823956928,
    "entry": 33729
  },
  {
    "userid": "282915",
    "username": "Alice",
    "creation_time": 1728823721237,
    "entry": 2159
  }
]

HTTP status code

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