---
title: "Get guild by name"
method: GET
path: "/guild/{query}"
tags: ["guild"]
---

# Get guild by name

`GET /guild/{query}`

<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>
Name queries are case-insensitive.
Use the `identifier` query parameter with either `username` or `uuid` to control how guild members are identified in the response.

## Path parameters

- `query` string, required

## Query parameters

- `identifier` 'username' | 'uuid'

## Response `200`

Guild detail.

- Guild
  - `uuid` string, uuid, required
  - `name` string, required
  - `prefix` string, required
  - `level` integer, required
  - `xpPercent` integer, required
  - `territories` integer, required
  - `wars` integer, required
  - `raids` integer, required
  - `created` string, date-time, required
  - `members` GuildMembers, required
    - `total` integer, required
    - `owner` object
    - `chief` object
    - `strategist` object
    - `recruiter` object
    - `recruit` object
  - `online` integer, required
  - `banner` GuildBanner, required
    - `base` 'BLACK' | 'RED' | 'GREEN' | 'BROWN' | 'BLUE' | 'PURPLE' | 'CYAN' | 'SILVER' | 'GRAY' | 'PINK' | 'LIME' | 'YELLOW' | 'LIGHT_BLUE' | 'MAGENTA' | 'ORANGE' | 'WHITE', required
    - `tier` integer, required
    - `structure` string, required
    - `layers` BannerLayer[], required
      - `color` 'BLACK' | 'RED' | 'GREEN' | 'BROWN' | 'BLUE' | 'PURPLE' | 'CYAN' | 'SILVER' | 'GRAY' | 'PINK' | 'LIME' | 'YELLOW' | 'LIGHT_BLUE' | 'MAGENTA' | 'ORANGE' | 'WHITE', required
      - `pattern` 'MOJANG' | 'RHOMBUS_MIDDLE' | 'SKULL' | 'SQUARE_BOTTOM_LEFT' | 'SQUARE_BOTTOM_RIGHT' | 'SQUARE_TOP_LEFT' | 'SQUARE_TOP_RIGHT' | 'STRAIGHT_CROSS' | 'STRIPE_BOTTOM' | 'STRIPE_CENTER' | 'STRIPE_DOWNLEFT' | 'STRIPE_DOWNRIGHT' | 'STRIPE_LEFT' | 'STRIPE_MIDDLE' | 'STRIPE_RIGHT' | 'STRIPE_SMALL' | 'STRIPE_TOP' | 'TRIANGLE_BOTTOM' | 'TRIANGLE_TOP' | 'TRIANGLES_BOTTOM' | 'TRIANGLES_TOP' | 'BASE' | 'BLANK' | 'BORDER' | 'BRICKS' | 'CIRCLE_MIDDLE' | 'CREEPER' | 'CROSS' | 'CURLY_BORDER' | 'DIAGONAL_LEFT' | 'DIAGONAL_LEFT_MIRROR' | 'DIAGONAL_RIGHT' | 'DIAGONAL_RIGHT_MIRROR' | 'FLOWER' | 'GRADIENT' | 'GRADIENT_UP' | 'HALF_HORIZONTAL' | 'HALF_HORIZONTAL_MIRROR' | 'HALF_VERTICAL' | 'HALF_VERTICAL_MIRROR', required
  - `seasonRanks` GuildSeasonRanks, required
  - `ranking` RankMap, required — Map of leaderboard type/name to rank position. See [GET /leaderboards/types](api:GET/leaderboards/types) for possible types.

## Other responses

- `404` — No matching guild was found.

---

[API](https://skmtc.dev/wynncraft/apis/modules.md) · [All operations](https://skmtc.dev/wynncraft/apis/modules/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wynncraft/modules/revisions/6c6214729eae/schema)