---
title: "GET /v1/admin/leaderboards/{leaderboardId}/players-list"
method: GET
path: "/v1/admin/leaderboards/{leaderboardId}/players-list"
tags: ["leaderboards"]
---

# GET /v1/admin/leaderboards/{leaderboardId}/players-list

`GET /v1/admin/leaderboards/{leaderboardId}/players-list`

## Request

- Base URL: `https://api.versusgame.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.versusgame.com/v1/admin/leaderboards/{leaderboardId}/players-list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/versusgame/apis/versusgame-api/docs/v1/admin/leaderboards/:leaderboardId/players-list/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `leaderboardId` string, required

## Query parameters

- `pickCount` number

## Response `200`

Get all Registered players for a given Leaderboard, sorted by points.

- ListLeaderboardPlayers
  - `items` LeaderboardPlayer[], required
    - `userId` string, required
    - `email` string, required
    - `username` string, required
    - `emailVerified` boolean, required
    - `leaderboardId` string, required
    - `points` number, required
    - `gamesDeclared` number, required
    - `gamesCorrectAnswers` number, required
  - `total` number, required
  - `next` string

## Other responses

- `400`
- `404`

---

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