Get guild by UUID

GET

https://api.wynncraft.com/v3/guild/uuid/:query

GET

/v3/guild/uuid/:query

1 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         "contributed": 64700439,
18         "contributionRank": 10,
19         "joined": "2020-11-20T19:44:37.126000Z",
20         "weekly": {
21           "completed": true,
22           "streak": 3
23         },
24         "globalData": {
25           "contentCompletion": 1860,
26           "wars": 6,
27           "totalLevel": 3278,
28           "mobsKilled": 470208,
29           "chestsFound": 3033,
30           "dungeons": {
31             "total": 2,
32             "list": {
33               "Decrepit Sewers": 1,
34               "Corrupted Decrepit Sewers": 1
35             }
36           },
37           "raids": {
38             "total": 1,
39             "list": {
40               "Nest of the Grootslang": 1
41             }
42           },
43           "worldEvents": 2,
44           "lootruns": 1,
45           "caves": 43,
46           "completedQuests": 313,
47           "pvp": {
48             "kills": 443,
49             "deaths": 666
50           },
51           "guildRaids": {
52             "total": 1,
53             "list": {
54               "Nest of the Grootslang": 1
55             }
56           },
57           "playtime": 2485.42
58         },
59         "restrictions": {
60           "online_status": false,
61           "main_access": false,
62           "weekly_access": true
63         },
64         "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
65         "username": "Nepmia"
66       }
67     },
68     "chief": {
69       "Nepmia": {
70         "online": false,
71         "lastJoin": "2026-03-19T23:45:48.667000Z",
72         "contributed": 64700439,
73         "contributionRank": 10,
74         "joined": "2020-11-20T19:44:37.126000Z",
75         "weekly": {
76           "completed": true,
77           "streak": 3
78         },
79         "globalData": {
80           "contentCompletion": 1860,
81           "wars": 6,
82           "totalLevel": 3278,
83           "mobsKilled": 470208,
84           "chestsFound": 3033,
85           "dungeons": {
86             "total": 2,
87             "list": {
88               "Decrepit Sewers": 1,
89               "Corrupted Decrepit Sewers": 1
90             }
91           },
92           "raids": {
93             "total": 1,
94             "list": {
95               "Nest of the Grootslang": 1
96             }
97           },
98           "worldEvents": 2,
99           "lootruns": 1,
100           "caves": 43,
101           "completedQuests": 313,
102           "pvp": {
103             "kills": 443,
104             "deaths": 666
105           },
106           "guildRaids": {
107             "total": 1,
108             "list": {
109               "Nest of the Grootslang": 1
110             }
111           },
112           "playtime": 2485.42
113         },
114         "restrictions": {
115           "online_status": false,
116           "main_access": false,
117           "weekly_access": true
118         },
119         "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
120         "username": "Nepmia"
121       }
122     },
123     "strategist": {
124       "Nepmia": {
125         "online": false,
126         "lastJoin": "2026-03-19T23:45:48.667000Z",
127         "contributed": 64700439,
128         "contributionRank": 10,
129         "joined": "2020-11-20T19:44:37.126000Z",
130         "weekly": {
131           "completed": true,
132           "streak": 3
133         },
134         "globalData": {
135           "contentCompletion": 1860,
136           "wars": 6,
137           "totalLevel": 3278,
138           "mobsKilled": 470208,
139           "chestsFound": 3033,
140           "dungeons": {
141             "total": 2,
142             "list": {
143               "Decrepit Sewers": 1,
144               "Corrupted Decrepit Sewers": 1
145             }
146           },
147           "raids": {
148             "total": 1,
149             "list": {
150               "Nest of the Grootslang": 1
151             }
152           },
153           "worldEvents": 2,
154           "lootruns": 1,
155           "caves": 43,
156           "completedQuests": 313,
157           "pvp": {
158             "kills": 443,
159             "deaths": 666
160           },
161           "guildRaids": {
162             "total": 1,
163             "list": {
164               "Nest of the Grootslang": 1
165             }
166           },
167           "playtime": 2485.42
168         },
169         "restrictions": {
170           "online_status": false,
171           "main_access": false,
172           "weekly_access": true
173         },
174         "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
175         "username": "Nepmia"
176       }
177     },
178     "recruiter": {
179       "Nepmia": {
180         "online": false,
181         "lastJoin": "2026-03-19T23:45:48.667000Z",
182         "contributed": 64700439,
183         "contributionRank": 10,
184         "joined": "2020-11-20T19:44:37.126000Z",
185         "weekly": {
186           "completed": true,
187           "streak": 3
188         },
189         "globalData": {
190           "contentCompletion": 1860,
191           "wars": 6,
192           "totalLevel": 3278,
193           "mobsKilled": 470208,
194           "chestsFound": 3033,
195           "dungeons": {
196             "total": 2,
197             "list": {
198               "Decrepit Sewers": 1,
199               "Corrupted Decrepit Sewers": 1
200             }
201           },
202           "raids": {
203             "total": 1,
204             "list": {
205               "Nest of the Grootslang": 1
206             }
207           },
208           "worldEvents": 2,
209           "lootruns": 1,
210           "caves": 43,
211           "completedQuests": 313,
212           "pvp": {
213             "kills": 443,
214             "deaths": 666
215           },
216           "guildRaids": {
217             "total": 1,
218             "list": {
219               "Nest of the Grootslang": 1
220             }
221           },
222           "playtime": 2485.42
223         },
224         "restrictions": {
225           "online_status": false,
226           "main_access": false,
227           "weekly_access": true
228         },
229         "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
230         "username": "Nepmia"
231       }
232     },
233     "recruit": {
234       "Nepmia": {
235         "online": false,
236         "lastJoin": "2026-03-19T23:45:48.667000Z",
237         "contributed": 64700439,
238         "contributionRank": 10,
239         "joined": "2020-11-20T19:44:37.126000Z",
240         "weekly": {
241           "completed": true,
242           "streak": 3
243         },
244         "globalData": {
245           "contentCompletion": 1860,
246           "wars": 6,
247           "totalLevel": 3278,
248           "mobsKilled": 470208,
249           "chestsFound": 3033,
250           "dungeons": {
251             "total": 2,
252             "list": {
253               "Decrepit Sewers": 1,
254               "Corrupted Decrepit Sewers": 1
255             }
256           },
257           "raids": {
258             "total": 1,
259             "list": {
260               "Nest of the Grootslang": 1
261             }
262           },
263           "worldEvents": 2,
264           "lootruns": 1,
265           "caves": 43,
266           "completedQuests": 313,
267           "pvp": {
268             "kills": 443,
269             "deaths": 666
270           },
271           "guildRaids": {
272             "total": 1,
273             "list": {
274               "Nest of the Grootslang": 1
275             }
276           },
277           "playtime": 2485.42
278         },
279         "restrictions": {
280           "online_status": false,
281           "main_access": false,
282           "weekly_access": true
283         },
284         "uuid": "98bc2236-ada5-4039-b560-8aaa4cc50384",
285         "username": "Nepmia"
286       }
287     }
288   },
289   "online": 0,
290   "banner": {
291     "base": "BLUE",
292     "tier": 5,
293     "structure": "tier5",
294     "layers": [
295       {
296         "color": "WHITE",
297         "pattern": "BRICKS"
298       },
299       {
300         "color": "MAGENTA",
301         "pattern": "GRADIENT"
302       },
303       {
304         "color": "LIGHT_BLUE",
305         "pattern": "GRADIENT_UP"
306       },
307       {
308         "color": "GREEN",
309         "pattern": "FLOWER"
310       },
311       {
312         "color": "LIME",
313         "pattern": "CIRCLE_MIDDLE"
314       },
315       {
316         "color": "GREEN",
317         "pattern": "MOJANG"
318       }
319     ]
320   },
321   "seasonRanks": {
322     "1": {
323       "rating": 10018,
324       "finalTerritories": 0
325     },
326     "5": {
327       "rating": 10025,
328       "finalTerritories": 0
329     }
330   },
331   "ranking": {}
332 }

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

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

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