---
title: "List Community Leaderboard"
method: GET
path: "/api/v3/community/leaderboard"
tags: ["Community"]
---

# List Community Leaderboard

`GET /api/v3/community/leaderboard`

Return leaderboard rows with optional filters (name, XP tier, skill rank), sorting (xp_amount, nickname, prestige_level, wr_count, map_count, playtest_count, discord_tag, skill_rank, skill_score), and pagination.

## Query parameters

- `name` string, nullable
- `tier_name` string, nullable
- `skill_rank` string, nullable
- `sort_column` 'xp_amount' | 'nickname' | 'prestige_level' | 'wr_count' | 'map_count' | 'playtest_count' | 'discord_tag' | 'skill_rank' | 'skill_score'
- `sort_direction` 'asc' | 'desc'
- `page_size` integer
- `page_number` integer

## Response `200`

Request fulfilled, document follows

- CommunityLeaderboardResponse[]
  - `user_id` integer, required
  - `nickname` string, nullable
  - `xp_amount` integer, required
  - `raw_tier` integer, required
  - `normalized_tier` integer, required
  - `prestige_level` integer, required
  - `tier_name` string, required
  - `wr_count` integer, required
  - `map_count` integer, required
  - `playtest_count` integer, required
  - `discord_tag` string, required
  - `skill_rank` string, required
  - `skill_score` number, required
  - `skill_tier` integer, required
  - `skill_percentile` number, required
  - `skill_tier_name` string, required
  - `total_results` integer, required

## Other responses

- `400` — Bad request syntax or unsupported method

---

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