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 detailed character data

GET
https://api.wynncraft.com/v3/player/:username/characters/:uuid
GET
/v3/player/:username/characters/:uuid
$curl https://api.wynncraft.com/v3/player/username/characters/uuid
1{
2  "type": "ASSASSIN",
3  "reskin": "NINJA",
4  "nickname": "Neplicopter",
5  "level": 106,
6  "xp": 53307528,
7  "xpPercent": 100,
8  "totalLevel": 369,
9  "preEconomy": null,
10  "gamemode": [],
11  "contentCompletion": 1860,
12  "wars": 6,
13  "playtime": 2485.42,
14  "mobsKilled": 470208,
15  "chestsFound": 3033,
16  "itemsIdentified": 42,
17  "blocksWalked": 123456,
18  "logins": 128,
19  "deaths": 666,
20  "discoveries": 120,
21  "pvp": {
22    "kills": 443,
23    "deaths": 666
24  },
25  "skillPoints": {
26    "strength": 0,
27    "dexterity": 0,
28    "intelligence": 0,
29    "defence": 0,
30    "agility": 0
31  },
32  "professions": {
33    "fishing": {
34      "level": 73,
35      "xpPercent": 41
36    },
37    "woodcutting": {
38      "level": 52,
39      "xpPercent": 88
40    },
41    "mining": {
42      "level": 68,
43      "xpPercent": 17
44    },
45    "farming": {
46      "level": 91,
47      "xpPercent": 64
48    },
49    "scribing": {
50      "level": 39,
51      "xpPercent": 22
52    },
53    "jeweling": {
54      "level": 57,
55      "xpPercent": 79
56    },
57    "alchemism": {
58      "level": 44,
59      "xpPercent": 35
60    },
61    "cooking": {
62      "level": 28,
63      "xpPercent": 93
64    },
65    "weaponsmithing": {
66      "level": 61,
67      "xpPercent": 11
68    },
69    "tailoring": {
70      "level": 34,
71      "xpPercent": 58
72    },
73    "woodworking": {
74      "level": 49,
75      "xpPercent": 84
76    },
77    "armouring": {
78      "level": 72,
79      "xpPercent": 26
80    }
81  },
82  "dungeons": {
83    "total": 2,
84    "list": {
85      "Decrepit Sewers": 1,
86      "Corrupted Decrepit Sewers": 1
87    }
88  },
89  "raids": {
90    "total": 1,
91    "list": {
92      "Nest of the Grootslangs": 1
93    }
94  },
95  "worldEvents": 2,
96  "lootruns": 1,
97  "caves": 43,
98  "quests": [
99    "A Journey Beyond"
100  ],
101  "restrictions": {
102    "characterDataAccess": false,
103    "characterBuildAccess": false
104  },
105  "removedStat": [],
106  "meta": {
107    "died": false
108  }
109}
<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> Character data is subject to [Access Rules](/privacy), which can hide some stats. Check the `restrictions` object to see which access rules affected the response. You can also check the `removedStat` field to check when the character skeleton customization affect 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> Returns the full stat payload for a single character.
Was this page helpful?
Previous

List a player's characters

Next

Get character ability map

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.

Character data is subject to Access Rules, which can hide some stats. Check the restrictions object to see which access rules affected the response. You can also check the removedStat field to check when the character skeleton customization affect 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.

Returns the full stat payload for a single character.

Path parameters

usernamestringRequired
Username or UUID accepted by the player route.
uuidstringRequiredformat: "uuid"

Response

Character detail.
typestring
reskinstring or null
nicknamestring or null
levelinteger
xpinteger
xpPercentinteger
totalLevelinteger
preEconomyboolean or null
gamemodelist of strings
contentCompletioninteger
warsinteger
playtimedouble
mobsKilledinteger
chestsFoundinteger
itemsIdentifiedinteger
blocksWalkedinteger
loginsinteger
deathsinteger
discoveriesinteger
pvpobject
skillPointsmap from strings to integers or null
professionsobject
dungeonsobject or null
raidsobject or null
worldEventsinteger
lootrunsinteger
cavesinteger
questslist of strings
restrictionsmap from strings to booleans
removedStatlist of strings

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error