---
title: "Get player profile"
method: GET
path: "/player/{username}"
tags: ["player"]
---

# Get player profile

`GET /player/{username}`

<Note>
This endpoint is cached for <Badge intent="success" minimal>2 minutes</Badge> in the <Badge intent="warning" minimal>USER</Badge> cache source.   See [Caching](/welcome#caching). <Indent></Indent> This endpoint belongs to the <Badge intent="warning" minimal>PLAYER</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits).
</Note>

<Warning>
Player stats are subject to [Access Rules](/privacy), which can hide some of the stats. Check the `restrictions` object to see which access rules affected the response.
</Warning>
<Info>
It is recommended to request players by UUID. Username lookups can return `300 MultipleObjectsReturned` with a multi-selector response when more than one player matches the query.
</Info>
`previousRanking` is stored daily based on player activity. Subtracting `previousRanking` from the current ranking gives the player's leaderboard progression.

<Info>
Use `fullResult` to include full character data. The `characters` object uses the same structure as [GET /player/{username}/characters/{uuid}](api:GET/player/{username}/characters/{uuid}).
</Info>

## Path parameters

- `username` string, required

## Query parameters

- `fullResult` ''

## Response `200`

Player profile.

- Player
  - `username` string, required
  - `online` boolean, required
  - `server` string, nullable, required
  - `activeCharacter` string, uuid, nullable, required
  - `nickname` string, nullable, required
  - `uuid` string, uuid, required
  - `rank` string, required
  - `rankBadge` string, required
  - `legacyRankColour` LegacyRankColour, required
    - `main` string, required
    - `sub` string, required
  - `shortenedRank` string, required
  - `supportRank` string, nullable, required
  - `veteran` boolean, required
  - `lastJoin` string, date-time, required
  - `guild` GuildReference, required
    - `uuid` string, uuid, required
    - `name` string, required
    - `prefix` string, required
    - `rank` string, nullable
    - `rankStars` string, nullable
  - `ranking` RankMap, required — Map of leaderboard type/name to rank position. See [GET /leaderboards/types](api:GET/leaderboards/types) for possible types.
  - `previousRanking` RankMap, required — Map of leaderboard type/name to rank position. See [GET /leaderboards/types](api:GET/leaderboards/types) for possible types.
  - `firstJoin` string, date-time, required
  - `playtime` number, double, required
  - `globalData` PlayerGlobalData, required
    - `contentCompletion` integer, required
    - `wars` integer, required
    - `totalLevel` integer, required
    - `mobsKilled` integer, required
    - `chestsFound` integer, required
    - `dungeons` DungeonCountList, required
      - `total` integer, required
      - `list` DungeonList, required
        - `Skeleton` integer
        - `Decrepit Sewers` integer
        - `Corrupted Decrepit Sewers` integer
        - `Spider` integer
        - `Infested Pit` integer
        - `Zombie` integer
        - `Timelost Sanctum` integer
        - `Underworld Crypt` integer
        - `Corrupted Underworld Crypt` integer
        - `Animal` integer
        - `Lost Sanctuary` integer
        - `Corrupted Lost Sanctuary` integer
        - `Silverfish` integer
        - `Sand-Swept Tomb` integer
        - `Corrupted Sand-Swept Tomb` integer
        - `Ice` integer
        - `Ice Barrows` integer
        - `Corrupted Ice Barrows` integer
        - `Jungle` integer
        - `Undergrowth Ruins` integer
        - `Corrupted Undergrowth Ruins` integer
        - `Ocean` integer
        - `Galleon's Graveyard` integer
        - `Corrupted Galleon's Graveyard` integer
        - `Fallen Factory` integer
        - `Eldritch Outlook` integer
    - `raids` RaidCountList, required
      - `total` integer, required
      - `list` RaidList, required
        - `Nest of the Grootslangs` integer
        - `Orphion's Nexus of Light` integer
        - `The Canyon Colossus` integer
        - `The Nameless Anomaly` integer
        - `The Wartorn Palace` integer
    - `worldEvents` integer, required
    - `lootruns` integer, required
    - `caves` integer, required
    - `completedQuests` integer, required
    - `guildRaids` RaidCountList, required
      - `total` integer, required
      - `list` RaidList, required
        - `Nest of the Grootslangs` integer
        - `Orphion's Nexus of Light` integer
        - `The Canyon Colossus` integer
        - `The Nameless Anomaly` integer
        - `The Wartorn Palace` integer
    - `raidStats` RaidStats, required
      - `damageTaken` integer, required
      - `damageDealt` integer, required
      - `healthHealed` integer, required
      - `deaths` integer, required
      - `buffsTaken` integer, required
      - `gambitsUsed` integer, required
    - `pvp` PvpStats, required
      - `kills` integer
      - `deaths` integer
  - `featuredStats` union, required
    - string
    - integer
  - `wallpaper` string, required
  - `avatar` string, required
  - `restrictions` object, required
  - `characters` object — <Info> Only present when `fullResult` is enabled. </Info>

## Other responses

- `404` — No matching player was found.
- `500` — Player payload construction failed.

---

[API](https://skmtc.dev/wynncraft/apis/modules.md) · [All operations](https://skmtc.dev/wynncraft/apis/modules/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wynncraft/modules/revisions/6c6214729eae/schema)