Hall of Heroes

GET /api/heroes

Get the heroes leaderboard

Returns the season leaderboard, highest renown (EP) first. Requires a signed-in session or the bot’s API key.

Parameters

Name	In	Type	Required	Description
season	query	string	no	A season ID, all, or month.

Response 200 — The leaderboard for the given season.

Model: HeroLeaderboard

Field	Type	Required	Description
season_id	string	yes
season_name	string	yes
rows	array of HeroRow	yes

GET /api/heroes/{member_id}

Get a hero profile

Returns one member’s full Hall of Heroes profile. Requires a signed-in session or the bot’s API key.

Parameters

Name	In	Type	Required	Description
member_id	path	integer	yes	The member’s ID.

Response 200 — The member’s Hall of Heroes profile.

Model: HeroProfile

Field	Type	Required	Description
member_id	integer	yes
discord_id	string	yes
display_name	string	yes
avatar_url	string | null	yes
wow_class	WowClass | null	yes
rank	integer | null	yes	Rank within the current season’s leaderboard, None if outside it (no EP this season).
chat_level	integer	yes
chat_xp	integer	yes
chat_xp_into_level	integer	yes
chat_xp_for_next_level	integer	yes
seasons	object	yes
all_time	HeroSeasonStats	yes
first_event_date	string (date) | null	yes
recent_events	array of HeroRecentEvent	yes
badges	array of EarnedBadge	yes