---
title: "Post Paged Player Leaderboard (Potentially for advanced queries)"
method: POST
path: "/leaderboards/{lbtype}"
tags: ["Leaderboards"]
---

# Post Paged Player Leaderboard (Potentially for advanced queries)

`POST /leaderboards/{lbtype}`

Retrieves a specific page of player leaderboard data for various game statistics, allowing for potential advanced queries via POST body.

## Path parameters

- `lbtype` string, required

## Request body

- RoutesPlayerLookupBody
  - `bedwars` TypesBedwarsPlayerCache
    - `activeBedDestroy` string
    - `activeDeathCry` string
    - `activeGlyph` string
    - `activeIslandTopper` string
    - `activeKillEffect` string
    - `activeKillMessages` string
    - `activeNPCSkin` string
    - `activeProjectileTrail` string
    - `activeSprays` string
    - `activeVictoryDance` string
    - `activeWoodType` string
    - `bedwars_exp` integer
    - `bedwars_level` integer
    - `displayname` string
    - `eight_one_beds_broken_bedwars` integer
    - `eight_one_beds_lost_bedwars` integer
    - `eight_one_deaths_bedwars` integer
    - `eight_one_final_deaths_bedwars` integer
    - `eight_one_final_kills_bedwars` integer
    - `eight_one_kills_bedwars` integer
    - `eight_one_losses_bedwars` integer
    - `eight_one_wins_bedwars` integer
    - `eight_two_beds_broken_bedwars` integer
    - `eight_two_beds_lost_bedwars` integer
    - `eight_two_deaths_bedwars` integer
    - `eight_two_final_deaths_bedwars` integer
    - `eight_two_final_kills_bedwars` integer
    - `eight_two_kills_bedwars` integer
    - `eight_two_losses_bedwars` integer
    - `eight_two_wins_bedwars` integer
    - `four_four_beds_broken_bedwars` integer
    - `four_four_beds_lost_bedwars` integer
    - `four_four_deaths_bedwars` integer
    - `four_four_final_deaths_bedwars` integer
    - `four_four_final_kills_bedwars` integer
    - `four_four_kills_bedwars` integer
    - `four_four_losses_bedwars` integer
    - `four_four_wins_bedwars` integer
    - `four_three_beds_broken_bedwars` integer
    - `four_three_beds_lost_bedwars` integer
    - `four_three_deaths_bedwars` integer
    - `four_three_final_deaths_bedwars` integer
    - `four_three_final_kills_bedwars` integer
    - `four_three_kills_bedwars` integer
    - `four_three_losses_bedwars` integer
    - `four_three_wins_bedwars` integer
    - `linked_discord` string
    - `overall_beds_broken_bedwars` integer
    - `overall_beds_lost_bedwars` integer
    - `overall_deaths_bedwars` integer
    - `overall_final_deaths_bedwars` integer
    - `overall_final_kills_bedwars` integer
    - `overall_kills_bedwars` integer
    - `overall_losses_bedwars` integer
    - `overall_wins_bedwars` integer
    - `player_rank` string
    - `quickbuy` string
    - `updated_at` string
    - `uuid` string
  - `difference` integer
  - `game_mode` string
  - `live_status` boolean
  - `skywars` TypesSkywarsPlayerCache
    - `activeKit_SOLO` string
    - `activeKit_SOLO_random` boolean
    - `activeKit_TEAMS` string
    - `activeKit_TEAMS_random` boolean
    - `active_balloon` string
    - `active_cage` string
    - `active_deathcry` string
    - `active_killeffect` string
    - `active_killmessages` string
    - `active_projectiletrail` string
    - `active_sprays` string
    - `active_victorydance` string
    - `displayname` string
    - `heads` integer
    - `kills` integer
    - `last_lobby_seen` string
    - `level` number
    - `player_rank` string
    - `seen_at` string
    - `updated_at` string
    - `uuid` string
    - `void_kills` integer

## Response `200`

Successfully retrieved a page of leaderboard data

- TypesBedwarsPlayerCache[]
  - `activeBedDestroy` string
  - `activeDeathCry` string
  - `activeGlyph` string
  - `activeIslandTopper` string
  - `activeKillEffect` string
  - `activeKillMessages` string
  - `activeNPCSkin` string
  - `activeProjectileTrail` string
  - `activeSprays` string
  - `activeVictoryDance` string
  - `activeWoodType` string
  - `bedwars_exp` integer
  - `bedwars_level` integer
  - `displayname` string
  - `eight_one_beds_broken_bedwars` integer
  - `eight_one_beds_lost_bedwars` integer
  - `eight_one_deaths_bedwars` integer
  - `eight_one_final_deaths_bedwars` integer
  - `eight_one_final_kills_bedwars` integer
  - `eight_one_kills_bedwars` integer
  - `eight_one_losses_bedwars` integer
  - `eight_one_wins_bedwars` integer
  - `eight_two_beds_broken_bedwars` integer
  - `eight_two_beds_lost_bedwars` integer
  - `eight_two_deaths_bedwars` integer
  - `eight_two_final_deaths_bedwars` integer
  - `eight_two_final_kills_bedwars` integer
  - `eight_two_kills_bedwars` integer
  - `eight_two_losses_bedwars` integer
  - `eight_two_wins_bedwars` integer
  - `four_four_beds_broken_bedwars` integer
  - `four_four_beds_lost_bedwars` integer
  - `four_four_deaths_bedwars` integer
  - `four_four_final_deaths_bedwars` integer
  - `four_four_final_kills_bedwars` integer
  - `four_four_kills_bedwars` integer
  - `four_four_losses_bedwars` integer
  - `four_four_wins_bedwars` integer
  - `four_three_beds_broken_bedwars` integer
  - `four_three_beds_lost_bedwars` integer
  - `four_three_deaths_bedwars` integer
  - `four_three_final_deaths_bedwars` integer
  - `four_three_final_kills_bedwars` integer
  - `four_three_kills_bedwars` integer
  - `four_three_losses_bedwars` integer
  - `four_three_wins_bedwars` integer
  - `linked_discord` string
  - `overall_beds_broken_bedwars` integer
  - `overall_beds_lost_bedwars` integer
  - `overall_deaths_bedwars` integer
  - `overall_final_deaths_bedwars` integer
  - `overall_final_kills_bedwars` integer
  - `overall_kills_bedwars` integer
  - `overall_losses_bedwars` integer
  - `overall_wins_bedwars` integer
  - `player_rank` string
  - `quickbuy` string
  - `updated_at` string
  - `uuid` string

## Other responses

- `400` — Bad request, e.g., invalid body, leaderboard type, or page number
- `401` — Unauthorized, not enough permissions
- `500` — Internal server error, e.g., failed to retrieve data from database

---

[API](https://skmtc.dev/seraph/apis/seraph-api.md) · [All operations](https://skmtc.dev/seraph/apis/seraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seraph/seraph-api/revisions/82a1ec01c64d/schema)