---
title: "Join Leaderboard"
method: POST
path: "/leaderboard/join"
tags: ["leaderboard"]
---

# Join Leaderboard

`POST /leaderboard/join`

Join the leaderboard. User must be at least level 2 to join.

## Request body

- JoinLeaderboardRequest
  - `leaderboard_username` string, required

## Response `200`

Successful Response

- 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

## 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)