---
title: "Fetch Hypixel Guild Data"
method: GET
path: "/hypixel/guild/{player}"
tags: ["Hypixel", "Guild"]
---

# Fetch Hypixel Guild Data

`GET /hypixel/guild/{player}`

Retrieves Hypixel guild data for a given player UUID. The data is cached for improved performance.

## Path parameters

- `player` string, required

## Response `200`

Successfully retrieved Hypixel guild data

- RoutesHypixelGuildData
  - `cache` integer
  - `cause` string
  - `guild` object
    - `_id` string
    - `achievements` unknown
    - `banner` unknown
    - `chatMute` integer
    - `coins` integer
    - `coinsEver` integer
    - `created` integer
    - `description` string
    - `exp` integer
    - `guildExpByGameType` unknown
    - `joinable` boolean
    - `legacyRanking` integer
    - `level_calc` number
    - `members` object[]
      - `displayname` string
      - `expHistory` unknown
      - `joined` integer
      - `mutedTill` integer
      - `name` string
      - `questParticipation` integer
      - `rank` string
      - `uuid` string
    - `name` string
    - `name_lower` string
    - `players` string[]
    - `preferredGames` string[]
    - `publiclyListed` boolean
    - `ranks` unknown[]
      - unknown
    - `tag` string
    - `tagColor` string
  - `success` boolean

## Other responses

- `400` — Bad request, e.g., invalid player UUID or failure to fetch data
- `500` — Internal server error or external API error

---

[API](https://skmtc.dev/seraph/apis/seraph-api.md) · [All operations](https://skmtc.dev/seraph/apis/seraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seraph/seraph-api/revisions/82a1ec01c64d/schema)