Get player profile | Wynncraft

1	curl https://api.wynncraft.com/v3/player/username

{
  "username": "Nepmia",
  "online": false,
  "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
  "rank": "WebDev",
  "rankBadge": "nextgen/badges/rank_webdev.svg",
  "legacyRankColour": {
    "main": "#aa0000",
    "sub": "#ff5555"
  },
  "shortenedRank": "WebDev",
  "supportRank": "champion",
  "veteran": false,
  "lastJoin": "2026-03-19T23:45:48.667000Z",
  "guild": {
    "uuid": "adb5f0b5-5289-439c-9293-a29d220e7152",
    "name": "Spectral Cabbage",
    "prefix": "SPC",
    "rank": "OWNER",
    "rankStars": "*****"
  },
  "ranking": {
    "playerContent": 67
  },
  "previousRanking": {
    "playerContent": 42
  },
  "firstJoin": "2015-04-29T17:22:00.000000Z",
  "playtime": 2485.42,
  "globalData": {
    "contentCompletion": 1860,
    "wars": 6,
    "totalLevel": 3278,
    "mobsKilled": 470208,
    "chestsFound": 3033,
    "dungeons": {
      "total": 2,
      "list": {
        "Decrepit Sewers": 1,
        "Corrupted Decrepit Sewers": 1
      }
    },
    "raids": {
      "total": 1,
      "list": {
        "Nest of the Grootslang": 1
      }
    },
    "worldEvents": 2,
    "lootruns": 1,
    "caves": 43,
    "completedQuests": 313,
    "guildRaids": {
      "total": 1,
      "list": {
        "Nest of the Grootslang": 1
      }
    },
    "raidStats": {
      "damageTaken": 180569,
      "damageDealt": 186268752,
      "healthHealed": 251434,
      "deaths": 11,
      "buffsTaken": 63,
      "gambitsUsed": 0
    },
    "pvp": {
      "kills": 443,
      "deaths": 666
    }
  },
  "featuredStats": {
    "globalData.chestsFound": 3067,
    "globalData.mobsKilled": 479814,
    "globalData.totalLevel": 4677,
    "firstJoin": "2013-10-23T20:02:38Z",
    "playtime": 2537.67
  },
  "wallpaper": "default",
  "avatar": "default",
  "restrictions": {
    "mainAccess": false,
    "characterDataAccess": false
  },
  "characters": {
    "5b6ab8a0-8f7c-4f50-bd2c-bfabe22d74bc": {
      "type": "ASSASSIN",
      "reskin": "NINJA",
      "nickname": "Neplicopter",
      "level": 106,
      "xp": 53307528,
      "xpPercent": 100,
      "totalLevel": 369,
      "gamemode": [],
      "contentCompletion": 1860,
      "wars": 6,
      "playtime": 2485.42,
      "mobsKilled": 470208,
      "chestsFound": 3033,
      "itemsIdentified": 42,
      "blocksWalked": 123456,
      "logins": 128,
      "deaths": 666,
      "discoveries": 120,
      "pvp": {
        "kills": 443,
        "deaths": 666
      },
      "skillPoints": {
        "strength": 0,
        "dexterity": 0,
        "intelligence": 0,
        "defence": 0,
        "agility": 0
      },
      "professions": {
        "fishing": {
          "level": 73,
          "xpPercent": 41
        },
        "woodcutting": {
          "level": 52,
          "xpPercent": 88
        },
        "mining": {
          "level": 68,
          "xpPercent": 17
        },
        "farming": {
          "level": 91,
          "xpPercent": 64
        },
        "scribing": {
          "level": 39,
          "xpPercent": 22
        },
        "jeweling": {
          "level": 57,
          "xpPercent": 79
        },
        "alchemism": {
          "level": 44,
          "xpPercent": 35
        },
        "cooking": {
          "level": 28,
          "xpPercent": 93
        },
        "weaponsmithing": {
          "level": 11,
          "xpPercent": 55
        },
        "tailoring": {
          "level": 6,
          "xpPercent": 44
        },
        "woodworking": {
          "level": 17,
          "xpPercent": 8
        },
        "armouring": {
          "level": 9,
          "xpPercent": 13
        }
      },
      "dungeons": {
        "total": 2,
        "list": {
          "Decrepit Sewers": 1,
          "Corrupted Decrepit Sewers": 1
        }
      },
      "raids": {
        "total": 1,
        "list": {
          "Nest of the Grootslang": 1
        }
      },
      "worldEvents": 2,
      "lootruns": 1,
      "caves": 43,
      "quests": [
        "King's Recruit",
        "The Canary Calls"
      ],
      "restrictions": {
        "characterDataAccess": false
      },
      "removedStat": []
    }
  }
}

This endpoint is cached for 2 minutes in the USER cache source.

Player stats are subject to Access Rules, which can hide some of the stats. Check the restrictions object to see which access rules affected the response.

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.

previousRanking is stored daily based on player activity. Subtracting previousRanking from the current ranking gives the player’s leaderboard progression.

Use fullResult to include full character data. The characters object uses the same structure as GET /player/{username}/characters/{uuid}.

<Note> This endpoint is cached for <Badge intent="success" minimal>2 minutes</Badge> in the <Badge intent="warning" minimal>USER</Badge> cache source. </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

usernamestringRequired

Username or UUID accepted by the player route.

Query parameters

fullResultenumOptional

Presence-based flag that expands responses. Send it without a value as ?fullResult. Using ?fullResult=true or ?fullResult=false is not accepted.

Allowed values:

Response

Player profile.

usernamestring

onlineboolean

serverstring or null

activeCharacterstring or nullformat: "uuid"

nicknamestring or null

uuidstringformat: "uuid"

rankstring

rankBadgestring

legacyRankColourobject

shortenedRankstring

supportRankstring or null

veteranboolean

lastJoindatetime

guildobject or null

rankingmap from strings to integers

Map of leaderboard type/name to rank position. See GET /leaderboards/types for possible types.

previousRankingmap from strings to integers

Map of leaderboard type/name to rank position. See GET /leaderboards/types for possible types.

firstJoindatetime

playtimedouble

globalDataobject

featuredStatsstring or integer

wallpaperstring

avatarstring

restrictionsmap from strings to booleans

charactersmap from strings to objects

Only present when fullResult is enabled.

Errors

404

Not Found Error

500

Internal Server Error