--- 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` ## Request - Base URL: `http://raider.io` - URL: `http://raider.io/api/v1/raiding/hall-of-fame` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) ## 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-unbinding-of-kithix' | 'the-venomous-abyss' | 'the-tidebound-grotto' | '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. "the-unbinding-of-kithix" or "The Unbinding of Kith'ix") - `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 ## Changes - **2026-10-06** `088fa4d90886`: 1 info - added the new enum value `the-unbinding-of-kithix` to the `query` request parameter `raid` - **2026-07-27** `af267384121d`: 1 info - added the new enum value `the-tidebound-grotto` to the `query` request parameter `raid` [Operation history](https://skmtc.dev/raider/apis/raider-io-developer-api/changes/api/v1/raiding/hall-of-fame/get.md) --- [API](https://skmtc.dev/raider/apis/raider-io-developer-api.md) - [All operations](https://skmtc.dev/raider/apis/raider-io-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/raider/apis/raider-io-developer-api/revisions/ac9847c578b8?raw)