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

Who Am I

GET
https://api.wynncraft.com/v3/player/whoami
GET
/v3/player/whoami
$curl https://api.wynncraft.com/v3/player/whoami
1{
2  "98bc2236-ada5-4039-b560-8aaa4cc50384": {
3    "username": "Nepmia",
4    "online": false,
5    "nickname": "Neplicopter",
6    "rank": "WebDev",
7    "supportRank": "champion",
8    "shortenedRank": "WebDev",
9    "legacyRankColour": {
10      "main": "#aa0000",
11      "sub": "#ff5555"
12    },
13    "rankBadge": "nextgen/badges/rank_webdev.svg"
14  }
15}
<Note> This endpoint is not cached. 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> Try it will not return usable data for this route. It depends on authentication and IP-aware context, so test it against the live API outside the docs. </Warning> Data returned here depends on the accounts you used to join Wynncraft. Those accounts represent who we think you are and are used for account-aware features such as store auto-login and map live position viewing.
Was this page helpful?
Previous

List online players

Next

Get player profile

Built with

This endpoint is not cached. See Caching.

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

Try it will not return usable data for this route. It depends on authentication and IP-aware context, so test it against the live API outside the docs.

Data returned here depends on the accounts you used to join Wynncraft. Those accounts represent who we think you are and are used for account-aware features such as store auto-login and map live position viewing.

Response

Identity mapping keyed by player UUID.
usernamestring
onlineboolean
nicknamestring or null
rankstring
supportRankstring or null
shortenedRankstring
legacyRankColourobject
rankBadgestring

Errors

403
Forbidden Error