Scoring & Tournaments
Fetching Scores

Fetching Scores

We display scores in a leaderboard, ordered by the score type set during the tournament's creation on Fractal's event page. If you want to display a leaderboard in-game or on your website, you can fetch the leaderboard data from our API.


Requires project API authentication. Always 'proxy' the scores through your server to avoid exposing your API authentication token.

Fetching a Score

To fetch a specific score object, send a request to score/(score_id) (opens in a new tab) GET Notice that the score id is a part of the request URL. Requests require a valid API authentication token to be passed in the Authorization header.

curl --request GET \
     --url '<SCORE_ID>' \
     --header 'accept: application/json'

Returns a score object that confronts the schema described here.