For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Create tokenDev Discord
  • Get started
    • Introduction
    • Authentication
    • API Privacy
    • Exceptions
    • Dev Discord
  • Modules
      • GETList online players
      • GETWho Am I
      • GETGet player profile
      • GETList a player's characters
      • GETGet detailed character data
      • GETGet character ability map
  • Changelog
    • v3.7.2 - OAuth2
    • v3.7.1
    • v3.7
    • v3.6 - Fruma Expansion
    • v3.5.2
    • v3.5.1
    • v3.5 - User System
    • v3.4
    • v3.3.4
    • v3.3.3
    • v3.3.2
    • v3.3.1
    • v3.3 - Rekindled World
    • v3.2.5
    • v3.2.4
    • v3.2.3
    • v3.2.2
    • v3.2.1
    • v3.2
    • v3.1
    • v3.0
LogoLogoWynncraft API - Documentation
Create tokenDev Discord
ModulesPlayer

Get player profile

GET
https://api.wynncraft.com/v3/player/:username
GET
/v3/player/:username
$curl https://api.wynncraft.com/v3/player/username
1{
2  "username": "Nepmia",
3  "online": false,
4  "server": null,
5  "activeCharacter": "5b6ab8a0-8f7c-4f50-bd2c-bfabe22d74bc",
6  "nickname": "Neplicopter",
7  "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
8  "rank": "WebDev",
9  "rankBadge": "nextgen/badges/rank_webdev.svg",
10  "legacyRankColour": {
11    "main": "#aa0000",
12    "sub": "#ff5555"
13  },
14  "shortenedRank": "WebDev",
15  "supportRank": "champion",
16  "veteran": false,
17  "lastJoin": "2026-03-19T23:45:48.667000Z",
18  "guild": {
19    "uuid": "adb5f0b5-5289-439c-9293-a29d220e7152",
20    "name": "Spectral Cabbage",
21    "prefix": "SPC",
22    "rank": "OWNER",
23    "rankStars": "*****"
24  },
25  "ranking": {
26    "playerContent": 67
27  },
28  "previousRanking": {
29    "playerContent": 42
30  },
31  "firstJoin": "2015-04-29T17:22:00.000000Z",
32  "playtime": 2485.42,
33  "globalData": {
34    "contentCompletion": 1860,
35    "wars": 6,
36    "totalLevel": 3278,
37    "mobsKilled": 470208,
38    "chestsFound": 3033,
39    "dungeons": {
40      "total": 2,
41      "list": {
42        "Decrepit Sewers": 1,
43        "Corrupted Decrepit Sewers": 1
44      }
45    },
46    "raids": {
47      "total": 1,
48      "list": {
49        "Nest of the Grootslangs": 1
50      }
51    },
52    "worldEvents": 2,
53    "lootruns": 1,
54    "caves": 43,
55    "completedQuests": 313,
56    "guildRaids": {
57      "total": 1,
58      "list": {
59        "Nest of the Grootslangs": 1
60      }
61    },
62    "raidStats": {
63      "damageTaken": 180569,
64      "damageDealt": 186268752,
65      "healthHealed": 251434,
66      "deaths": 11,
67      "buffsTaken": 63,
68      "gambitsUsed": 0
69    },
70    "pvp": {
71      "kills": 443,
72      "deaths": 666
73    }
74  },
75  "featuredStats": {
76    "globalData.chestsFound": 3067,
77    "globalData.mobsKilled": 479814,
78    "globalData.totalLevel": 4677,
79    "firstJoin": "2013-10-23T20:02:38Z",
80    "playtime": 2537.67
81  },
82  "wallpaper": "default",
83  "avatar": "default",
84  "restrictions": {
85    "mainAccess": false,
86    "characterDataAccess": false
87  },
88  "characters": {
89    "5b6ab8a0-8f7c-4f50-bd2c-bfabe22d74bc": {
90      "type": "ASSASSIN",
91      "reskin": "NINJA",
92      "nickname": "Neplicopter",
93      "level": 106,
94      "xp": 53307528,
95      "xpPercent": 100,
96      "totalLevel": 369,
97      "preEconomy": null,
98      "gamemode": [],
99      "contentCompletion": 1860,
100      "wars": 6,
101      "playtime": 2485.42,
102      "mobsKilled": 470208,
103      "chestsFound": 3033,
104      "itemsIdentified": 42,
105      "blocksWalked": 123456,
106      "logins": 128,
107      "deaths": 666,
108      "discoveries": 120,
109      "pvp": {
110        "kills": 443,
111        "deaths": 666
112      },
113      "skillPoints": {
114        "strength": 0,
115        "dexterity": 0,
116        "intelligence": 0,
117        "defence": 0,
118        "agility": 0
119      },
120      "professions": {
121        "fishing": {
122          "level": 73,
123          "xpPercent": 41
124        },
125        "woodcutting": {
126          "level": 52,
127          "xpPercent": 88
128        },
129        "mining": {
130          "level": 68,
131          "xpPercent": 17
132        },
133        "farming": {
134          "level": 91,
135          "xpPercent": 64
136        },
137        "scribing": {
138          "level": 39,
139          "xpPercent": 22
140        },
141        "jeweling": {
142          "level": 57,
143          "xpPercent": 79
144        },
145        "alchemism": {
146          "level": 44,
147          "xpPercent": 35
148        },
149        "cooking": {
150          "level": 28,
151          "xpPercent": 93
152        },
153        "weaponsmithing": {
154          "level": 11,
155          "xpPercent": 55
156        },
157        "tailoring": {
158          "level": 6,
159          "xpPercent": 44
160        },
161        "woodworking": {
162          "level": 17,
163          "xpPercent": 8
164        },
165        "armouring": {
166          "level": 9,
167          "xpPercent": 13
168        }
169      },
170      "dungeons": {
171        "total": 2,
172        "list": {
173          "Decrepit Sewers": 1,
174          "Corrupted Decrepit Sewers": 1
175        }
176      },
177      "raids": {
178        "total": 1,
179        "list": {
180          "Nest of the Grootslangs": 1
181        }
182      },
183      "worldEvents": 2,
184      "lootruns": 1,
185      "caves": 43,
186      "quests": [
187        "King's Recruit",
188        "The Canary Calls"
189      ],
190      "restrictions": {
191        "characterDataAccess": false
192      },
193      "removedStat": []
194    }
195  }
196}
<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>
Was this page helpful?
Previous

Who Am I

Next

List a player's characters

Built with

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

This endpoint belongs to the PLAYER rate-limit bucket. See Throttling and Rate Limits.

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}.

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