---
title: "Retrieve the hall of fame for a given raid"
method: GET
path: "/api/v1/raiding/hall-of-fame"
tags: ["raiding"]
---

# Retrieve the hall of fame for a given raid

`GET /api/v1/raiding/hall-of-fame`

## Query parameters

- `access_key` string — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
- `raid` 'the-tidebound-grotto' | 'the-venomous-abyss' | 'sporefall' | 'tier-mn-1' | 'manaforge-omega' | 'liberation-of-undermine' | 'nerubar-palace' | 'blackrock-depths' | 'awakened-amirdrassil-the-dreams-hope' | 'awakened-aberrus-the-shadowed-crucible' | 'awakened-vault-of-the-incarnates' | 'amirdrassil-the-dreams-hope' | 'aberrus-the-shadowed-crucible' | 'vault-of-the-incarnates' | 'fated-sepulcher-of-the-first-ones' | 'fated-sanctum-of-domination' | 'fated-castle-nathria' | 'sepulcher-of-the-first-ones' | 'sanctum-of-domination' | 'castle-nathria' | 'nyalotha-the-waking-city' | 'the-eternal-palace' | 'crucible-of-storms' | 'battle-of-dazaralor' | 'uldir' | 'antorus-the-burning-throne' | 'tomb-of-sargeras' | 'the-nighthold' | 'trial-of-valor' | 'the-emerald-nightmare', required — Raid slug or full name (e.g. "sporefall" or "Sporefall")
- `difficulty` 'mythic' | 'heroic' | 'normal', required — Raid difficulty. One of: mythic, heroic, normal
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn' | 'world', required — Name of region to restrict progress to. Can be one of: world, us, eu, kr, tw

## Response `200`

Successful

- ViewHallOfFameResponse
  - `hallOfFame` HallOfFame
    - `winningGuilds` HallOfFameGuildEntry[] — Top guilds in the hall of fame
      - `guild` RaidingGuild
        - `id` integer — Guild ID
        - `name` string — Guild name
        - `faction` string
        - `realm` FullRealm
          - `id` integer
          - `name` string
          - `slug` string
          - `altName` string, nullable
          - `altSlug` string
          - `locale` string
          - `isConnected` boolean
          - `connectedRealmId` integer
          - `realmType` string
          - `wowRealmId` integer
          - `wowConnectedRealmId` integer
        - `region` RegionSummary
          - `name` string, required — Name of the region
          - `short_name` string, required — Short name of the region
          - `slug` string, required — Slug for the region, suitable for putting in URLs
        - `path` string — URL path to guild profile
        - `logo` string, nullable — Guild logo URL
        - `color` string — Guild brand color
        - `isDefaultLogo` boolean
        - `displayName` string
      - `rank` integer
      - `encountersDefeated` EncounterDefeated[]
        - `slug` string
        - `firstDefeated` string, nullable
        - `lastDefeated` string, nullable
      - `recruitmentProfiles` RecruitmentProfile[]
        - `activity_type` string — Type of recruitment activity (e.g. guild_raids)
        - `entity_type` string — Entity type (e.g. guild)
        - `recruitment_profile_id` integer — Recruitment profile ID
      - `streamers` Streamers — Active streamers for this guild
        - `count` integer — Number of active streamers
        - `stream` Stream1, nullable — Featured or top stream
          - `is_featured_stream` boolean
          - `activity_record_id` integer
          - `id` string — Stream ID
          - `name` string — Streamer username
          - `user_id` string
          - `game_id` string
          - `type` string — Stream status (e.g. live)
          - `title` string
          - `community_ids` string[]
          - `viewer_count` integer
          - `started_at` string
          - `language` string
          - `thumbnail_url` string
    - `bossKills` HallOfFameBossKill[] — Boss kill entries
      - `boss` string — Boss slug
      - `bossSummary` BossSummary
        - `encounterId` integer
        - `name` string
        - `slug` string
        - `ordinal` integer
        - `wingId` integer
        - `iconUrl` string
      - `bossKillVideo` union — Kill video(s) if available
        - BossKillVideo — unresolved $ref
        - string, nullable
      - `defeatedBy` DefeatedBy
        - `totalCount` integer — Total guilds that defeated this boss
        - `guilds` DefeatedByGuild[] — Sample of guilds that defeated this boss
          - `guild` RaidingGuild
            - `id` integer — Guild ID
            - `name` string — Guild name
            - `faction` string
            - `realm` FullRealm
              - …
            - `region` RegionSummary
              - …
            - `path` string — URL path to guild profile
            - `logo` string, nullable — Guild logo URL
            - `color` string — Guild brand color
            - `isDefaultLogo` boolean
            - `displayName` string
          - `rank` integer
          - `encountersDefeated` EncounterDefeated[]
            - `slug` string
            - `firstDefeated` string, nullable
            - `lastDefeated` string, nullable
      - `attemptedBy` AttemptedBy
        - `totalCount` integer — Total guilds that attempted this boss
        - `attempts` AttemptGuild[] — Sample of guilds that attempted this boss
          - `guild` RaidingGuild
            - `id` integer — Guild ID
            - `name` string — Guild name
            - `faction` string
            - `realm` FullRealm
              - …
            - `region` RegionSummary
              - …
            - `path` string — URL path to guild profile
            - `logo` string, nullable — Guild logo URL
            - `color` string — Guild brand color
            - `isDefaultLogo` boolean
            - `displayName` string
          - `rank` integer
          - `encountersDefeated` EncounterDefeated[]
            - `slug` string
            - `firstDefeated` string, nullable
            - `lastDefeated` string, nullable

---

[API](https://skmtc.net/raider/apis/raider-io-developer-api.md) · [All operations](https://skmtc.net/raider/apis/raider-io-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/raider/raider-io-developer-api/revisions/4c612ac925bb/schema)