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 guilds
      • GETList territories
      • GETList guild seasons
      • GETGet guild by prefix
      • GETGet guild by UUID
      • GETGet guild by name
  • 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
ModulesGuild

Get guild by UUID

GET
https://api.wynncraft.com/v3/guild/uuid/:query
GET
/v3/guild/uuid/:query
$curl https://api.wynncraft.com/v3/guild/uuid/query
1{
2  "uuid": "adb5f0b5-5289-439c-9293-a29d220e7152",
3  "name": "Spectral Cabbage",
4  "prefix": "SPC",
5  "level": 70,
6  "xpPercent": 23,
7  "territories": 0,
8  "wars": 197,
9  "raids": 0,
10  "created": "2016-12-12T19:58:37.021000Z",
11  "members": {
12    "total": 5,
13    "owner": {
14      "Nepmia": {
15        "online": false,
16        "lastJoin": "2026-03-19T23:45:48.667000Z",
17        "server": null,
18        "contributed": 64700439,
19        "contributionRank": 10,
20        "joined": "2020-11-20T19:44:37.126000Z",
21        "weekly": {
22          "completed": true,
23          "streak": 3
24        },
25        "globalData": {
26          "contentCompletion": 1860,
27          "wars": 6,
28          "totalLevel": 3278,
29          "mobsKilled": 470208,
30          "chestsFound": 3033,
31          "dungeons": {
32            "total": 2,
33            "list": {
34              "Decrepit Sewers": 1,
35              "Corrupted Decrepit Sewers": 1
36            }
37          },
38          "raids": {
39            "total": 1,
40            "list": {
41              "Nest of the Grootslangs": 1
42            }
43          },
44          "worldEvents": 2,
45          "lootruns": 1,
46          "caves": 43,
47          "completedQuests": 313,
48          "pvp": {
49            "kills": 443,
50            "deaths": 666
51          },
52          "currentGuildRaids": {
53            "total": 1,
54            "list": {
55              "Nest of the Grootslangs": 1
56            }
57          },
58          "guildRaids": {
59            "total": 4,
60            "list": {
61              "Nest of the Grootslangs": 3,
62              "The Canyon Colossus": 1
63            }
64          },
65          "playtime": 2485.42
66        },
67        "restrictions": {
68          "online_status": false,
69          "main_access": false,
70          "guild_high_ranked_access": true
71        },
72        "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
73        "username": "Nepmia"
74      }
75    },
76    "chief": {
77      "Nepmia": {
78        "online": false,
79        "lastJoin": "2026-03-19T23:45:48.667000Z",
80        "server": null,
81        "contributed": 64700439,
82        "contributionRank": 10,
83        "joined": "2020-11-20T19:44:37.126000Z",
84        "weekly": {
85          "completed": true,
86          "streak": 3
87        },
88        "globalData": {
89          "contentCompletion": 1860,
90          "wars": 6,
91          "totalLevel": 3278,
92          "mobsKilled": 470208,
93          "chestsFound": 3033,
94          "dungeons": {
95            "total": 2,
96            "list": {
97              "Decrepit Sewers": 1,
98              "Corrupted Decrepit Sewers": 1
99            }
100          },
101          "raids": {
102            "total": 1,
103            "list": {
104              "Nest of the Grootslangs": 1
105            }
106          },
107          "worldEvents": 2,
108          "lootruns": 1,
109          "caves": 43,
110          "completedQuests": 313,
111          "pvp": {
112            "kills": 443,
113            "deaths": 666
114          },
115          "currentGuildRaids": {
116            "total": 1,
117            "list": {
118              "Nest of the Grootslangs": 1
119            }
120          },
121          "guildRaids": {
122            "total": 4,
123            "list": {
124              "Nest of the Grootslangs": 3,
125              "The Canyon Colossus": 1
126            }
127          },
128          "playtime": 2485.42
129        },
130        "restrictions": {
131          "online_status": false,
132          "main_access": false,
133          "guild_high_ranked_access": true
134        },
135        "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
136        "username": "Nepmia"
137      }
138    },
139    "strategist": {
140      "Nepmia": {
141        "online": false,
142        "lastJoin": "2026-03-19T23:45:48.667000Z",
143        "server": null,
144        "contributed": 64700439,
145        "contributionRank": 10,
146        "joined": "2020-11-20T19:44:37.126000Z",
147        "weekly": {
148          "completed": true,
149          "streak": 3
150        },
151        "globalData": {
152          "contentCompletion": 1860,
153          "wars": 6,
154          "totalLevel": 3278,
155          "mobsKilled": 470208,
156          "chestsFound": 3033,
157          "dungeons": {
158            "total": 2,
159            "list": {
160              "Decrepit Sewers": 1,
161              "Corrupted Decrepit Sewers": 1
162            }
163          },
164          "raids": {
165            "total": 1,
166            "list": {
167              "Nest of the Grootslangs": 1
168            }
169          },
170          "worldEvents": 2,
171          "lootruns": 1,
172          "caves": 43,
173          "completedQuests": 313,
174          "pvp": {
175            "kills": 443,
176            "deaths": 666
177          },
178          "currentGuildRaids": {
179            "total": 1,
180            "list": {
181              "Nest of the Grootslangs": 1
182            }
183          },
184          "guildRaids": {
185            "total": 4,
186            "list": {
187              "Nest of the Grootslangs": 3,
188              "The Canyon Colossus": 1
189            }
190          },
191          "playtime": 2485.42
192        },
193        "restrictions": {
194          "online_status": false,
195          "main_access": false,
196          "guild_high_ranked_access": true
197        },
198        "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
199        "username": "Nepmia"
200      }
201    },
202    "recruiter": {
203      "Nepmia": {
204        "online": false,
205        "lastJoin": "2026-03-19T23:45:48.667000Z",
206        "server": null,
207        "contributed": 64700439,
208        "contributionRank": 10,
209        "joined": "2020-11-20T19:44:37.126000Z",
210        "weekly": {
211          "completed": true,
212          "streak": 3
213        },
214        "globalData": {
215          "contentCompletion": 1860,
216          "wars": 6,
217          "totalLevel": 3278,
218          "mobsKilled": 470208,
219          "chestsFound": 3033,
220          "dungeons": {
221            "total": 2,
222            "list": {
223              "Decrepit Sewers": 1,
224              "Corrupted Decrepit Sewers": 1
225            }
226          },
227          "raids": {
228            "total": 1,
229            "list": {
230              "Nest of the Grootslangs": 1
231            }
232          },
233          "worldEvents": 2,
234          "lootruns": 1,
235          "caves": 43,
236          "completedQuests": 313,
237          "pvp": {
238            "kills": 443,
239            "deaths": 666
240          },
241          "currentGuildRaids": {
242            "total": 1,
243            "list": {
244              "Nest of the Grootslangs": 1
245            }
246          },
247          "guildRaids": {
248            "total": 4,
249            "list": {
250              "Nest of the Grootslangs": 3,
251              "The Canyon Colossus": 1
252            }
253          },
254          "playtime": 2485.42
255        },
256        "restrictions": {
257          "online_status": false,
258          "main_access": false,
259          "guild_high_ranked_access": true
260        },
261        "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
262        "username": "Nepmia"
263      }
264    },
265    "recruit": {
266      "Nepmia": {
267        "online": false,
268        "lastJoin": "2026-03-19T23:45:48.667000Z",
269        "server": null,
270        "contributed": 64700439,
271        "contributionRank": 10,
272        "joined": "2020-11-20T19:44:37.126000Z",
273        "weekly": {
274          "completed": true,
275          "streak": 3
276        },
277        "globalData": {
278          "contentCompletion": 1860,
279          "wars": 6,
280          "totalLevel": 3278,
281          "mobsKilled": 470208,
282          "chestsFound": 3033,
283          "dungeons": {
284            "total": 2,
285            "list": {
286              "Decrepit Sewers": 1,
287              "Corrupted Decrepit Sewers": 1
288            }
289          },
290          "raids": {
291            "total": 1,
292            "list": {
293              "Nest of the Grootslangs": 1
294            }
295          },
296          "worldEvents": 2,
297          "lootruns": 1,
298          "caves": 43,
299          "completedQuests": 313,
300          "pvp": {
301            "kills": 443,
302            "deaths": 666
303          },
304          "currentGuildRaids": {
305            "total": 1,
306            "list": {
307              "Nest of the Grootslangs": 1
308            }
309          },
310          "guildRaids": {
311            "total": 4,
312            "list": {
313              "Nest of the Grootslangs": 3,
314              "The Canyon Colossus": 1
315            }
316          },
317          "playtime": 2485.42
318        },
319        "restrictions": {
320          "online_status": false,
321          "main_access": false,
322          "guild_high_ranked_access": true
323        },
324        "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
325        "username": "Nepmia"
326      }
327    }
328  },
329  "online": 0,
330  "banner": {
331    "base": "BLUE",
332    "tier": 5,
333    "structure": "tier5",
334    "layers": [
335      {
336        "color": "WHITE",
337        "pattern": "BRICKS"
338      },
339      {
340        "color": "MAGENTA",
341        "pattern": "GRADIENT"
342      },
343      {
344        "color": "LIGHT_BLUE",
345        "pattern": "GRADIENT_UP"
346      },
347      {
348        "color": "GREEN",
349        "pattern": "FLOWER"
350      },
351      {
352        "color": "LIME",
353        "pattern": "CIRCLE_MIDDLE"
354      },
355      {
356        "color": "GREEN",
357        "pattern": "MOJANG"
358      }
359    ]
360  },
361  "seasonRanks": {
362    "1": {
363      "rating": 10018,
364      "finalTerritories": 0
365    },
366    "5": {
367      "rating": 10025,
368      "finalTerritories": 0
369    }
370  },
371  "ranking": {}
372}
<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>GUILD</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits). </Note> Use the `identifier` query parameter with either `username` or `uuid` to control how guild members are identified in the response.
Was this page helpful?
Previous

Get guild by prefix

Next

Get guild by name

Built with

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

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

Use the identifier query parameter with either username or uuid to control how guild members are identified in the response.

Path parameters

querystringRequired

Query parameters

identifierenumOptional
Switches player descriptor between either their username or their uuid.
Allowed values:

Response

Guild detail.
uuidstringformat: "uuid"
namestring
prefixstring
levelinteger
xpPercentinteger
territoriesinteger
warsinteger
raidsinteger
createddatetime
membersobject
onlineinteger
bannerobject
seasonRanksmap from strings to objects
rankingmap from strings to integers

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

Errors

404
Not Found Error