Documentation

​
​

Development

User Acquisition

Monetization

Industry

Leaderboards

Unity SDK

Admin API

Client API

Open Unity Dashboard

Leaderboards

LiveOps
​
​
Leaderboards
  • Overview
  • Get started
  • Concepts
  • Tutorials
    • Configuration
    • Unity SDK tutorial
      • Add a new score
      • Get the player's score
      • Get scores
      • Get a range of scores centered around the player
      • Get scores for other players
      • Get scores for a certain tier
      • Get a list of available leaderboard versions
      • Get the player's score from a leaderboard version
      • Get scores from a leaderboard version
      • Get a range of scores centered around the player from a leaderboard version
      • Get scores for other players from a leaderboard version
      • Get scores for a certain tier from a leaderboard version
    • Unity SDK sample
    • Cloud Code samples
  • Reference
  • Privacy and consent
  1. Leaderboards
  3. Unity SDK tutorial

Get a list of available leaderboard versions

Retrieve a list of archived versions of a leaderboard.
Read time 1 minute
Last updated 9 months ago
If the leaderboard resets and existing scores are archived, this call returns the current leaderboard versionId, and a list of archived versions in reverse chronological order. For example, the first entry is the archived version containing the most recent scores.
If you have a scheduled reset configured on your leaderboard, this method also returns the next time that the leaderboard resets based on your schedule as the 
nextReset
property.
Use the 
GetVersionsAsync
method below to get a list of available leaderboard versions:
public async void GetLeaderboardVersions(string leaderboardId){    var versionsResponse = await LeaderboardsService.Instance        .GetVersionsAsync(leaderboardId);    // Get the ID of the most recently archived Leaderboard version    var versionId = versionsResponse.Results[0].Id;    Debug.Log(JsonConvert.SerializeObject(versionsResponse.Results));}
Retrieving a set of the most recent versions only is available with the 
GetVersionsOptions
object with the optional 
Limit
pagination argument.
Limit
is the number of leaderboard scores to return, starting with the most recent. Defaults to null and returns all versions.
public async void GetLeaderboardVersions(string leaderboardId){    var versionsResponse = await LeaderboardsService.Instance        .GetVersionsAsync(            leaderboardId,            new GetVersionsOptions { Limit = 10 }        );    // Get the ID of the most recently archived Leaderboard version    var versionId = versionsResponse.Results[0].Id;    Debug.Log(JsonConvert.SerializeObject(versionsResponse.Results));}
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

    Report a problem with this page