---
title: "Get Leaderboard"
method: GET
path: "/leaderboard"
tags: ["leaderboard"]
---

# Get Leaderboard

`GET /leaderboard`

Get the leaderboard data, including top users and current user's position.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- RoutersLeaderboardLeaderboardResponse
  - `top_users` LeaderboardUserResponse[], required
    - `leaderboard_username` string, required
    - `level` integer, required
    - `xp` integer, required
    - `level_name` string, required
    - `level_altitude` string, required
    - `joined_at` string, date-time, required
    - `rank` integer, nullable
    - `is_current_user` boolean
  - `current_user` LeaderboardUserResponse
    - `leaderboard_username` string, required
    - `level` integer, required
    - `xp` integer, required
    - `level_name` string, required
    - `level_altitude` string, required
    - `joined_at` string, date-time, required
    - `rank` integer, nullable
    - `is_current_user` boolean
  - `current_user_rank` integer, nullable
  - `total_users` integer, required
  - `user_eligible` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/c407f3b5a05b/schema)