# 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: {ref}`HeroLeaderboard <model-heroleaderboard>`

| Field | Type | Required | Description |
|---|---|---|---|
| `season_id` | string | yes |  |
| `season_name` | string | yes |  |
| `rows` | array of {ref}`HeroRow <model-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: {ref}`HeroProfile <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` | {ref}`WowClass <model-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` | {ref}`HeroSeasonStats <model-heroseasonstats>` | yes |  |
| `first_event_date` | string (date) \| null | yes |  |
| `recent_events` | array of {ref}`HeroRecentEvent <model-herorecentevent>` | yes |  |
| `badges` | array of {ref}`EarnedBadge <model-earnedbadge>` | yes |  |