> For the complete documentation index, see [llms.txt](https://dynamicpixels.gitbook.io/dynamicpixels-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dynamicpixels.gitbook.io/dynamicpixels-docs/unity-sdk/leaderboard.md).

# Leaderboard

Explore the list of API functions available in Unity for managing leaderboards and player scores, including detailed descriptions and usage examples.

{% hint style="warning" %}
To use services functions, first ensure that the service is activated before. You can see services by opening "Service Hub" From game's dashboard header. 
{% endhint %}

### Get Available Leaderboards[​](https://docs.dynamicpixels.dev/leaderboards/plugin#get-available-leaderboards) <a href="#get-available-leaderboards" id="get-available-leaderboards"></a>

Retrieves a list of leaderboards based on the provided parameters.

```csharp
var leaderboards = await ServiceHub.Services.Leaderboard.GetLeaderboards(new GetLeaderboardsParams
{
    label = null,
    skip = 0,
    limit = 0
});
```

### Get Users Scores[​](https://docs.dynamicpixels.dev/leaderboards/plugin#get-users-scores) <a href="#get-users-scores" id="get-users-scores"></a>

Obtains scores for individual users as specified by the input parameters.

```csharp
var scores = await ServiceHub.Services.Leaderboard.GetUsersScores<GetScoresParams, UserScore>(new GetScoresParams
{
    Leaderboardid = 0,
    skip = 0,
    limit = 0,
    returnUserScore = false,
    Conditions = new Eq("field", "value").ToQuery()
});
```

### Get Parties Scores[​](https://docs.dynamicpixels.dev/leaderboards/plugin#get-parties-scores) <a href="#get-parties-scores" id="get-parties-scores"></a>

Fetches scores for different parties (e.g., teams or groups) according to the given parameters.

```csharp
var scores = await ServiceHub.Services.Leaderboard.GetPartiesScores<GetScoresParams, PartyScore>(new GetScoresParams
{
    Leaderboardid = 0,
    skip = 0,
    limit = 0,
    returnUserScore = false,
    Conditions = new Eq("field", "value").ToQuery()
});
```

### Get Friends Scores[​](https://docs.dynamicpixels.dev/leaderboards/plugin#get-friends-scores) <a href="#get-friends-scores" id="get-friends-scores"></a>

Gathers scores specifically for friends of the current user.

```csharp
var scores = await ServiceHub.Services.Leaderboard.GetFriendsScores(new GetFriendsScoresParams
{
    LeaderboardId = 0,
    Skip = 0,
    Limit = 0
});
```

### Get My Score[​](https://docs.dynamicpixels.dev/leaderboards/plugin#get-my-score) <a href="#get-my-score" id="get-my-score"></a>

Retrieves the score of the current user based on the input parameters.

```csharp
var score = await ServiceHub.Services.Leaderboard.GetMyScore<GetCurrentUserScoreParams, UserScore>(new GetCurrentUserScoreParams
{
    LeaderboardId = 0,
    Conditions = new Eq("field", "value").ToQuery()
});
```

### Submit New Score[​](https://docs.dynamicpixels.dev/leaderboards/plugin#submit-new-score) <a href="#submit-new-score" id="submit-new-score"></a>

Submits a user's score and returns the result.

```csharp
var score = await ServiceHub.Services.Leaderboard.SubmitScore<SubmitScoreParams, UserScore>(
new SubmitScoreParams
{
    LeaderboardId = 0,
    Score = 0,
    OtherData = new Dictionary<string, dynamic>(),
    PartyId = 0,
    UniqueBy = "extended_field"
});
```