---
title: "Top Players on a Leaderboard"
method: GET
path: "/leaderboard-statistics/brand/{brandId}/leaderboard/{leaderboardId}/top"
tags: ["Leaderboard Statistics"]
---

# Top Players on a Leaderboard

`GET /leaderboard-statistics/brand/{brandId}/leaderboard/{leaderboardId}/top`

## Request

- Base URL: `https://opti-ls-api-us.optimove.net/api`
- URL: `https://opti-ls-api-us.optimove.net/api/leaderboard-statistics/brand/{brandId}/leaderboard/{leaderboardId}/top`
- Auth: none declared

Returns the top players ordered by score descending. The response has no `rank` field. Derive rank from the array position (`index + 1`).

## Path parameters

- `brandId` string, uuid, required
- `leaderboardId` string, required

## Query parameters

- `limit` integer

## Response `200`

Top players, sorted by score descending.

- PlayerScore[]
  - `playerId` string
  - `playerName` string, nullable: Display name at the time of last score update. `null` if not set.
  - `score` integer: Player's accumulated score on this leaderboard.

---

[API](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api.md) - [All operations](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api/llms.txt) - [OpenAPI document](https://skmtc.dev/optimove/apis/optimove-loyalty-system-api/revisions/f174877a5fb7?raw)