---
title: "Player Lookup"
method: POST
path: "/player/lookup"
tags: ["Player", "Search"]
---

# Player Lookup

`POST /player/lookup`

Retrieves player data based on game mode and applied filters.

## Headers

- `Authorization` 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`

Successful lookup for Skywars game mode

- union
  - RoutesPlayerLookupBedwarsResponse
    - `difference` integer
    - `results` 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
  - RoutesPlayerLookupSkywarsResponse
    - `difference` integer
    - `results` 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

## Other responses

- `400` — Bad Request: Invalid game mode, missing parameters, or invalid filter combination
- `401` — Unauthorized: Not enough permission

---

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