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 scores for other players from a leaderboard version

Retrieve scores for other players from a specific leaderboard version.
Read time 1 minute
Last updated 9 months ago
Get the scores for other players from a leaderboard version with the 
GetVersionScoresByPlayerIdsAsync
method:
public async void GetVersionScoresByPlayerIds(string leaderboardId, string versionId){    var playerIds = new List<string>{ "abc123", "abc456" };    var scoresResponse = await LeaderboardsService.Instance        .GetVersionScoresByPlayerIdsAsync(            leaderboardId,            versionId,            playerIds        );    Debug.Log(JsonConvert.SerializeObject(scoresResponse));}
Note
Metadata is not retrieved by default.
To get the score with any associated metadata, use the 
IncludeMetadata
option on the 
GetVersionScoresByPlayerIdsOptions
configuration object:
public async void GetVersionScoresByPlayerIdsWithMetadata(string leaderboardId, string versionId){    var playerIds = new List<string>{ "abc123", "abc456" };    var scoreResponse = await LeaderboardsService.Instance        .GetVersionScoresByPlayerIdsAsync(            leaderboardId,            versionId,            playerIds,            new GetVersionScoresByPlayerIdsOptions { IncludeMetadata = true }        );    Debug.Log(JsonConvert.SerializeObject(scoreResponse));}
For details on how to get available leaderboard version IDs, visit Get available leaderboard version.
Note
For methods that retrieve scores: if your player has not submitted a score and the leaderboard is bucketed, the player is not assigned a bucket. A failed score retrieval returns an error that has its 
Reason
field set to 
ScoreSubmissionRequired
.
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