Top times / Podium

Description

Use this endpoint to retrieve the top times submitted for a Timeboard.

Endpoint

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

Request URL Parameters

Parameter	Description
count	How many top times to get

Example

GET https://api.gamerank.io/timeboard/top/10

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 time has been submitted
entry	int	Submitted time (in millisecond)

The order is from the #1 position of the timeboard, up to the count you provided. E.g., if you set count to 3, a podium is returned.

[
  {
    "userid": "382911",
    "username": "Ada",
    "creation_time": 1730642812412,
    "entry": 237050
  },
  {
    "userid": "221281",
    "username": "John",
    "creation_time": 1730026754899,
    "entry": 215111
  },
  {
    "userid": "901281",
    "username": "Paul",
    "creation_time": 1730026114899,
    "entry": 202290
  }
]

HTTP status code

HTTP status	Reason(s)
200	• OK
404	• Unknown API key / timeboard
500	• Server Error, please contact support@gamerank.io