---
title: "List the top players of a game set (leaderboard)"
method: GET
path: "/gameset/plays/gamesets/{gameSetId}/top-players"
tags: ["gameset-plays"]
---

# List the top players of a game set (leaderboard)

`GET /gameset/plays/gamesets/{gameSetId}/top-players`

Ranked by the most games played for that GameSet.

## Path parameters

- `gameSetId` string, required

## Query parameters

- `limit` number
- `cursor` string
- `withExternalId` boolean

## Response `200`

Ranked list of top players with usernames

- TopPlayersForGameSetResponseEntity
  - `items` RankedPlayerStandings[], required
    - `userId` string, required — Usually a UUID, but older users may have a numberic id
    - `externalId` string — The player's externalId
    - `username` string, required — The player's username
    - `avatarUrl` string, required — The player's avatar URL
    - `gamesPlayedCount` number, required — Total games played in that GameSet attempt
    - `correctAnswerCount` number, required — Total correct answers in that GameSet attempt
  - `cursor` string

---

[API](https://skmtc.net/versusgame/apis/versusgame-api.md) · [All operations](https://skmtc.net/versusgame/apis/versusgame-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/versusgame/versusgame-api/revisions/e86f45ae5f7c/schema)