# Raider.IO

> Track World of Warcraft characters and guilds on Raider.IO: Mythic+ scores, runs and gear, raid progress and rankings, this week's affixes, season cut-offs and leaderboards. No account or API key is required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/raider-io

## Actions

### Get boss rankings

Get the guilds that killed a raid boss first on a difficulty, in order, across the world, a region or one realm.

**Inputs**

- Raid (`raid`, text, required): The raid, from this expansion or the one before.
- Boss (`boss`, text, required): The boss, from the raid picked.
- Difficulty (`difficulty`, text, required): The raid difficulty. One of: `mythic`, `heroic`, `normal`. Default: `mythic`.
- Region (`region`, text, required): Rank across the world, one region, or a group of realms such as Oceanic or German realms. One of: `world`, `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China), `us-english` (US: English realms), `us-spanish` (US: Spanish realms), `brazil` (US: Brazilian realms), `oceanic` (US: Oceanic realms), and 11 more. Default: `world`.
- Realm (`realm`, text): Only guilds on this realm. Leave empty for the whole region. Only when Region is Americas & Oceania (US), Europe, Korea, Taiwan or China.

**Outputs**

- `boss` (text)
- `boss_name` (text)
- `difficulty` (text)
- `guild_count` (number)
- `guilds` (list)
- `raid` (text)
- `raid_name` (text)
- `realm` (text)
- `region` (text)

**Example output**

```json
{
  "boss": "ulatek",
  "boss_name": "Ula'tek",
  "difficulty": "mythic",
  "guild_count": 1,
  "guilds": [
    {
      "defeated_at": "2026-09-03T19:04:00Z",
      "faction": "horde",
      "guild_id": 1712677,
      "name": "Liquid",
      "profile_url": "https://raider.io/guilds/us/illidan/Liquid",
      "rank": 1,
      "realm": "Illidan",
      "realm_slug": "illidan",
      "region": "us",
      "region_rank": 1
    }
  ],
  "raid": "the-venomous-abyss",
  "raid_name": "The Venomous Abyss",
  "realm": null,
  "region": "world"
}
```

### Get character

Look up a World of Warcraft character on Raider.IO: class, spec, race and faction, plus whichever extras you tick, such as the Mythic+ score, item level, raid progress, guild, rankings, recent and best runs, and talent loadout code.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Character name (`name`, text, required): The character's name. Capital letters don't matter.
- Include (`include`, list): What to add to the character's profile. One or more of: `mythic_plus_score` (Mythic+ score), `mythic_plus_ranks` (Mythic+ rankings), `item_level` (Item level), `raid_progress` (Raid progress), `guild`, `recent_runs` (Recent Mythic+ runs), `best_runs` (Best Mythic+ runs), `talents` (Talent loadout code). Default: `["mythic_plus_score", "item_level", "raid_progress", "guild"]`.

**Outputs**

- `achievement_points` (number)
- `best_runs` (list)
- `class` (text)
- `class_realm_rank` (number)
- `class_region_rank` (number)
- `class_world_rank` (number)
- `dps_score` (number)
- `faction` (text)
- `gender` (text)
- `guild_name` (text)
- `guild_realm` (text)
- `healer_score` (number)
- `included` (list)
- `item_level` (number)
- `last_updated` (text)
- `mythic_plus_score` (number)
- `mythic_plus_score_color` (text)
- `name` (text)
- `profile_url` (text)
- `race` (text)
- `raid_progress` (list)
- `realm` (text)
- `realm_rank` (number)
- `recent_runs` (list)
- `region` (text)
- `region_rank` (number)
- `role` (text)
- `spec` (text)
- `talent_loadout_code` (text)
- `tank_score` (number)
- `thumbnail_url` (text)
- `world_rank` (number)

**Example output**

```json
{
  "achievement_points": 21470,
  "best_runs": null,
  "class": "Shaman",
  "class_realm_rank": null,
  "class_region_rank": null,
  "class_world_rank": null,
  "dps_score": 3331.7,
  "faction": "horde",
  "gender": "female",
  "guild_name": "Resonate",
  "guild_realm": "Bleeding Hollow",
  "healer_score": 4133,
  "included": [
    "mythic_plus_score",
    "item_level",
    "raid_progress",
    "guild"
  ],
  "item_level": 330,
  "last_updated": "2026-10-15T10:07:36Z",
  "mythic_plus_score": 4133,
  "mythic_plus_score_color": "#fd7c23",
  "name": "Pookiexo",
  "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
  "race": "Orc",
  "raid_progress": [
    {
      "heroic_bosses_killed": 8,
      "mythic_bosses_killed": 0,
      "normal_bosses_killed": 4,
      "raid": "the-venomous-abyss",
      "raid_name": "The Venomous Abyss",
      "summary": "8/8 H",
      "total_bosses": 8
    }
  ],
  "realm": "Illidan",
  "realm_rank": null,
  "recent_runs": null,
  "region": "us",
  "region_rank": null,
  "role": "healer",
  "spec": "Restoration",
  "talent_loadout_code": null,
  "tank_score": 0,
  "thumbnail_url": "https://render.worldofwarcraft.com/us/character/illidan/211/216748499-avatar.jpg",
  "world_rank": null
}
```

### Get character's gear

Get the gear a character was last seen wearing: item level, and for each slot the item, its item level and quality, whether it's a tier set piece, its enchants and gems, and a Wowhead link.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Character name (`name`, text, required): The character's name. Capital letters don't matter.

**Outputs**

- `class` (text)
- `item_count` (number)
- `item_level` (number)
- `items` (list)
- `name` (text)
- `profile_url` (text)
- `realm` (text)
- `region` (text)
- `role` (text)
- `spec` (text)
- `tier_set_pieces` (number)
- `updated_at` (text)

**Example output**

```json
{
  "class": "Shaman",
  "item_count": 1,
  "item_level": 330,
  "items": [
    {
      "enchants": [
        "Enchant Helm - Empowered Rune of Avoidance"
      ],
      "gems": [],
      "item_id": 271483,
      "item_level": 334,
      "name": "Serpent Crown of the Ophidian Oracle",
      "quality": "Epic",
      "slot": "head",
      "slot_name": "Head",
      "tier_set": true,
      "wowhead_url": "https://www.wowhead.com/item=271483?bonus=13335:40:13696"
    }
  ],
  "name": "Pookiexo",
  "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
  "realm": "Illidan",
  "region": "us",
  "role": "healer",
  "spec": "Restoration",
  "tier_set_pieces": 1,
  "updated_at": "2026-10-15T10:07:36Z"
}
```

### Get character's raid progress

Get how many bosses a character has killed on Normal, Heroic and Mythic in each raid of this expansion, newest raid first, and when they earned Ahead of the Curve and Cutting Edge.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Character name (`name`, text, required): The character's name. Capital letters don't matter.
- Raid (`raid`, text): Only this raid. Leave empty for every raid of this expansion.

**Outputs**

- `class` (text)
- `name` (text)
- `profile_url` (text)
- `raid_count` (number)
- `raids` (list)
- `realm` (text)
- `region` (text)
- `role` (text)
- `spec` (text)

**Example output**

```json
{
  "class": "Shaman",
  "name": "Pookiexo",
  "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
  "raid_count": 1,
  "raids": [
    {
      "ahead_of_the_curve_at": "2026-08-22T20:31:01Z",
      "cutting_edge_at": null,
      "heroic_bosses_killed": 8,
      "mythic_bosses_killed": 0,
      "normal_bosses_killed": 4,
      "raid": "the-venomous-abyss",
      "raid_name": "The Venomous Abyss",
      "summary": "8/8 H",
      "total_bosses": 8
    }
  ],
  "realm": "Illidan",
  "region": "us",
  "role": "healer",
  "spec": "Restoration"
}
```

### Get guild boss kill

Find out whether and when a guild first killed a raid boss on a difficulty, how long the fight took, the raid's item level, and who was there.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Guild name (`guild`, text, required): The guild's name, spaces included. Capital letters don't matter.
- Raid (`raid`, text, required): The raid, from this expansion or the one before.
- Boss (`boss`, text, required): The boss, from the raid picked.
- Difficulty (`difficulty`, text, required): The raid difficulty. One of: `mythic`, `heroic`, `normal`. Default: `heroic`.

**Outputs**

- `boss` (text)
- `boss_name` (text)
- `defeated_at` (text)
- `difficulty` (text)
- `fight_duration` (text)
- `fight_duration_seconds` (number)
- `guild` (text)
- `item_level_average` (number)
- `item_level_max` (number)
- `item_level_min` (number)
- `killed` (true/false)
- `pulled_at` (text)
- `raid` (text)
- `raid_name` (text)
- `realm` (text)
- `region` (text)
- `roster` (list)
- `roster_size` (number)

**Example output**

```json
{
  "boss": "ulatek",
  "boss_name": "Ula'tek",
  "defeated_at": "2026-09-03T19:04:00Z",
  "difficulty": "mythic",
  "fight_duration": "10:03",
  "fight_duration_seconds": 603,
  "guild": "Liquid",
  "item_level_average": 326.1,
  "item_level_max": 332.1,
  "item_level_min": 323.8,
  "killed": true,
  "pulled_at": "2026-09-03T18:53:57Z",
  "raid": "the-venomous-abyss",
  "raid_name": "The Venomous Abyss",
  "realm": "Illidan",
  "region": "us",
  "roster": [
    {
      "class": "Mage",
      "item_level": 327.2,
      "name": "Infiammato",
      "profile_url": "https://raider.io/characters/us/illidan/Infiammato",
      "realm": "Illidan",
      "region": "us",
      "role": "dps",
      "spec": "Arcane"
    }
  ],
  "roster_size": 1
}
```

### Get guild raid progress

Get a guild's progress in each raid of this expansion, newest first: bosses killed on each difficulty (like 8/8 H) and its world, region and realm rank on each.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Guild name (`guild`, text, required): The guild's name, spaces included. Capital letters don't matter.
- Raid (`raid`, text): Only this raid. Leave empty for every raid of this expansion.

**Outputs**

- `faction` (text)
- `last_updated` (text)
- `latest_raid` (text)
- `latest_summary` (text)
- `name` (text)
- `profile_url` (text)
- `raid_count` (number)
- `raids` (list)
- `realm` (text)
- `region` (text)

**Example output**

```json
{
  "faction": "horde",
  "last_updated": "2026-10-15T07:07:29Z",
  "latest_raid": "The Venomous Abyss",
  "latest_summary": "8/8 M",
  "name": "Liquid",
  "profile_url": "https://raider.io/guilds/us/illidan/Liquid",
  "raid_count": 1,
  "raids": [
    {
      "heroic_bosses_killed": 8,
      "heroic_realm_rank": 1,
      "heroic_region_rank": 1,
      "heroic_world_rank": 1,
      "mythic_bosses_killed": 8,
      "mythic_realm_rank": 1,
      "mythic_region_rank": 1,
      "mythic_world_rank": 1,
      "normal_bosses_killed": 4,
      "normal_realm_rank": 1,
      "normal_region_rank": 1,
      "normal_world_rank": 1,
      "raid": "the-venomous-abyss",
      "raid_name": "The Venomous Abyss",
      "summary": "8/8 M",
      "total_bosses": 8
    }
  ],
  "realm": "Illidan",
  "region": "us"
}
```

### Get Mythic+ leaderboard

Get the top Mythic+ runs of a season, 20 per page, across the world or in one region, for every dungeon or just one. Each run lists its team, time, score and a link.

**Inputs**

- Region (`region`, text, required): Rank across the world or within one region. One of: `world`, `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `world`.
- Season (`season`, text): The Mythic+ season. 'Current season' always follows the season running now. Default: `current`.
- Dungeon (`dungeon`, text): Only runs of this dungeon. Leave empty for all.
- Page (`page`, number): Which page of 20 runs. Page 1 is the top 20. From 1 to 100. Default: `1`.

**Outputs**

- `dungeon` (text)
- `leaderboard_url` (text)
- `page` (number)
- `region` (text)
- `run_count` (number)
- `runs` (list)
- `season` (text)
- `season_name` (text)

**Example output**

```json
{
  "dungeon": null,
  "leaderboard_url": "https://raider.io/mythic-plus-rankings/season-mn-2/all/world/leaderboards-strict",
  "page": 1,
  "region": "world",
  "run_count": 1,
  "runs": [
    {
      "affixes": [
        "Fortified",
        "Tyrannical",
        "Xal'atath's Guile"
      ],
      "clear_time": "27:54",
      "clear_time_seconds": 1674,
      "completed_at": "2026-10-15T05:03:49Z",
      "dungeon": "Den of Nalorakk",
      "dungeon_short_name": "DON",
      "dungeon_slug": "den-of-nalorakk",
      "faction": "mixed",
      "key_level": 22,
      "keystone_upgrades": 1,
      "rank": 1,
      "run_id": 20708819,
      "score": 519.8,
      "season": "season-mn-2",
      "team": [
        {
          "class": "Shaman",
          "name": "Pookiexo",
          "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
          "realm": "Illidan",
          "realm_slug": "illidan",
          "region": "us",
          "role": "healer",
          "spec": "Restoration"
        }
      ],
      "time_left_seconds": 247,
      "time_limit_seconds": 1921,
      "timed": true,
      "url": "https://raider.io/mythic-plus-runs/season-mn-2/20708819-22-den-of-nalorakk"
    }
  ],
  "season": "season-mn-2",
  "season_name": "MN Season 2"
}
```

### Get Mythic+ run

Look up one Mythic+ run by its number or Raider.IO link: the dungeon, key level, time, score, affixes, deaths, and each player's spec, item level and guild.

**Inputs**

- Run (`run_id`, text, required): The run's number (run_id from another Raider.IO step) or its raider.io/mythic-plus-runs link.
- Season (`season`, text): The season the run was in. A run link already says, so leave this as it is when you give one. Default: `current`.

**Outputs**

- `affixes` (list)
- `clear_time` (text)
- `clear_time_seconds` (number)
- `completed_at` (text)
- `deaths` (number)
- `dungeon` (text)
- `dungeon_short_name` (text)
- `dungeon_slug` (text)
- `faction` (text)
- `key_level` (number)
- `keystone_upgrades` (number)
- `run_id` (number)
- `score` (number)
- `season` (text)
- `team` (list)
- `time_left_seconds` (number)
- `time_limit_seconds` (number)
- `timed` (true/false)
- `url` (text)

**Example output**

```json
{
  "affixes": [
    "Fortified",
    "Tyrannical",
    "Xal'atath's Guile"
  ],
  "clear_time": "27:54",
  "clear_time_seconds": 1674,
  "completed_at": "2026-10-15T05:03:49Z",
  "deaths": 4,
  "dungeon": "Den of Nalorakk",
  "dungeon_short_name": "DON",
  "dungeon_slug": "den-of-nalorakk",
  "faction": "mixed",
  "key_level": 22,
  "keystone_upgrades": 1,
  "run_id": 20708819,
  "score": 519.8,
  "season": "season-mn-2",
  "team": [
    {
      "class": "Shaman",
      "guild": "Resonate",
      "item_level": 330.6,
      "name": "Pookiexo",
      "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
      "realm": "Illidan",
      "realm_slug": "illidan",
      "region": "us",
      "role": "healer",
      "spec": "Restoration"
    }
  ],
  "time_left_seconds": 247,
  "time_limit_seconds": 1921,
  "timed": true,
  "url": "https://raider.io/mythic-plus-runs/season-mn-2/20708819-22-den-of-nalorakk"
}
```

### Get Mythic+ score

Get a character's Mythic+ score for a season, overall and as tank, healer and damage, with the colour Raider.IO shows it in, world, region and realm ranks for the current season, and how many runs they've done and timed in each dungeon.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Character name (`name`, text, required): The character's name. Capital letters don't matter.
- Season (`season`, text): The Mythic+ season. 'Current season' always follows the season running now. Default: `current`.

**Outputs**

- `class` (text)
- `class_realm_rank` (number)
- `class_region_rank` (number)
- `class_world_rank` (number)
- `dps_score` (number)
- `dungeons` (list)
- `healer_score` (number)
- `name` (text)
- `profile_url` (text)
- `realm` (text)
- `realm_rank` (number)
- `region` (text)
- `region_rank` (number)
- `role` (text)
- `score` (number)
- `score_color` (text)
- `season` (text)
- `season_name` (text)
- `spec` (text)
- `tank_score` (number)
- `timed_runs` (number)
- `total_runs` (number)
- `world_rank` (number)

**Example output**

```json
{
  "class": "Shaman",
  "class_realm_rank": 2,
  "class_region_rank": 2,
  "class_world_rank": 31,
  "dps_score": 3331.7,
  "dungeons": [
    {
      "dungeon": "Murder Row",
      "runs": 64,
      "short_name": "MR",
      "timed_runs": 62
    }
  ],
  "healer_score": 4133,
  "name": "Pookiexo",
  "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
  "realm": "Illidan",
  "realm_rank": 4,
  "region": "us",
  "region_rank": 6,
  "role": "healer",
  "score": 4133,
  "score_color": "#fd7c23",
  "season": "season-mn-2",
  "season_name": "MN Season 2",
  "spec": "Restoration",
  "tank_score": 0,
  "timed_runs": 62,
  "total_runs": 64,
  "world_rank": 167
}
```

### Get raid hall of fame

Get the first three guilds to kill each boss of a raid, how many guilds have killed it since, and the raid's overall winners.

**Inputs**

- Raid (`raid`, text, required): The raid, from this expansion or the one before.
- Difficulty (`difficulty`, text, required): The raid difficulty. One of: `mythic`, `heroic`, `normal`. Default: `mythic`.
- Region (`region`, text, required): Rank across the world or within one region. One of: `world`, `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `world`.

**Outputs**

- `bosses` (list)
- `difficulty` (text)
- `raid` (text)
- `raid_name` (text)
- `region` (text)
- `winning_guilds` (list)

**Example output**

```json
{
  "bosses": [
    {
      "boss": "ulatek",
      "boss_name": "Ula'tek",
      "first_defeated_at": "2026-09-03T19:04:00Z",
      "first_kills": [
        {
          "defeated_at": "2026-09-03T19:04:00Z",
          "faction": "horde",
          "guild_id": 1712677,
          "name": "Liquid",
          "profile_url": "https://raider.io/guilds/us/illidan/Liquid",
          "realm": "Illidan",
          "realm_slug": "illidan",
          "region": "us"
        }
      ],
      "guilds_defeated": 247
    }
  ],
  "difficulty": "mythic",
  "raid": "the-venomous-abyss",
  "raid_name": "The Venomous Abyss",
  "region": "world",
  "winning_guilds": [
    {
      "faction": "horde",
      "guild_id": 1712677,
      "name": "Liquid",
      "profile_url": "https://raider.io/guilds/us/illidan/Liquid",
      "rank": 1,
      "realm": "Illidan",
      "realm_slug": "illidan",
      "region": "us"
    }
  ]
}
```

### Get raid progression stats

See how far guilds have got in a raid: how many guilds stand at each number of bosses killed, and how many have cleared it.

**Inputs**

- Raid (`raid`, text, required): The raid, from this expansion or the one before.
- Difficulty (`difficulty`, text, required): The raid difficulty. One of: `mythic`, `heroic`, `normal`. Default: `mythic`.
- Region (`region`, text, required): Rank across the world or within one region. One of: `world`, `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `world`.

**Outputs**

- `difficulty` (text)
- `guilds_cleared` (number)
- `guilds_with_kills` (number)
- `milestones` (list)
- `raid` (text)
- `raid_name` (text)
- `region` (text)
- `total_bosses` (number)

**Example output**

```json
{
  "difficulty": "mythic",
  "guilds_cleared": 251,
  "guilds_with_kills": 5482,
  "milestones": [
    {
      "bosses_defeated": 8,
      "guilds": 251,
      "guilds_at_or_beyond": 251,
      "progress": "8/8 M"
    }
  ],
  "raid": "the-venomous-abyss",
  "raid_name": "The Venomous Abyss",
  "region": "world",
  "total_bosses": 8
}
```

### Get raid rankings

Get the guild leaderboard for a raid and difficulty across the world, a region, a group of realms or one realm, with each guild's progress and latest kill.

**Inputs**

- Raid (`raid`, text, required): The raid, from this expansion or the one before.
- Difficulty (`difficulty`, text, required): The raid difficulty. One of: `mythic`, `heroic`, `normal`. Default: `mythic`.
- Region (`region`, text, required): Rank across the world, one region, or a group of realms such as Oceanic or German realms. One of: `world`, `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China), `us-english` (US: English realms), `us-spanish` (US: Spanish realms), `brazil` (US: Brazilian realms), `oceanic` (US: Oceanic realms), and 11 more. Default: `world`.
- Realm (`realm`, text): Only guilds on this realm. Leave empty for the whole region. Only when Region is Americas & Oceania (US), Europe, Korea, Taiwan or China.
- Number of guilds (`limit`, number): How many guilds to return. Defaults to 25. From 1 to 200. Default: `25`.
- Page (`page`, number): Which page of guilds. Page 1 is the top. From 1 to 10000. Default: `1`.

**Outputs**

- `difficulty` (text)
- `guild_count` (number)
- `guilds` (list)
- `page` (number)
- `raid` (text)
- `raid_name` (text)
- `realm` (text)
- `region` (text)
- `total_bosses` (number)

**Example output**

```json
{
  "difficulty": "mythic",
  "guild_count": 1,
  "guilds": [
    {
      "bosses_defeated": 8,
      "faction": "horde",
      "guild_id": 1712677,
      "latest_kill_at": "2026-09-03T19:04:00Z",
      "name": "Liquid",
      "profile_url": "https://raider.io/guilds/us/illidan/Liquid",
      "progress": "8/8 M",
      "rank": 1,
      "realm": "Illidan",
      "realm_slug": "illidan",
      "region": "us",
      "region_rank": 1
    }
  ],
  "page": 1,
  "raid": "the-venomous-abyss",
  "raid_name": "The Venomous Abyss",
  "realm": null,
  "region": "world",
  "total_bosses": 8
}
```

### Get score colour

Get the colour Raider.IO shows a Mythic+ score in, for colour-coding a message, along with every score tier of the season.

**Inputs**

- Score (`score`, number): The score to find the colour of. Leave empty to only list the tiers. From 0 to 10000.
- Season (`season`, text): The Mythic+ season. 'Current season' always follows the season running now. Default: `current`.

**Outputs**

- `color` (text)
- `score` (number)
- `season` (text)
- `season_name` (text)
- `tier_count` (number)
- `tiers` (list)

**Example output**

```json
{
  "color": "#5fc087",
  "score": 2500,
  "season": "season-mn-2",
  "season_name": "MN Season 2",
  "tier_count": 2,
  "tiers": [
    {
      "color": "#ff8000",
      "score": 4200
    },
    {
      "color": "#5fc087",
      "score": 2495
    }
  ]
}
```

### Get season cut-offs

Get the Mythic+ score needed to be in the top 0.1% (the season title), 1%, 10%, 25% and 40% of a region, overall and for each faction.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Season (`season`, text): The Mythic+ season. 'Current season' always follows the season running now. Default: `current`.

**Outputs**

- `cutoffs` (list)
- `region` (text)
- `season` (text)
- `season_name` (text)
- `top_0_1_percent_score` (number)
- `top_10_percent_score` (number)
- `top_1_percent_score` (number)
- `top_25_percent_score` (number)
- `top_40_percent_score` (number)
- `total_characters` (number)
- `updated_at` (text)

**Example output**

```json
{
  "cutoffs": [
    {
      "alliance_score": 3927.6,
      "characters": 674,
      "color": "#ee656b",
      "horde_score": 3775.53,
      "key": "top_0_1_percent",
      "label": "Top 0.1%",
      "score": 3894.53,
      "top_percent": 0.1
    }
  ],
  "region": "us",
  "season": "season-mn-2",
  "season_name": "MN Season 2",
  "top_0_1_percent_score": 3894.53,
  "top_10_percent_score": 3223.44,
  "top_1_percent_score": 3663.35,
  "top_25_percent_score": 2962.74,
  "top_40_percent_score": 2654.71,
  "total_characters": 673380,
  "updated_at": "2026-10-15T13:45:11Z"
}
```

### Get this week's affixes

Get this week's Mythic+ affixes in a region, each with what it does and a Wowhead link.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.

**Outputs**

- `affix_names` (list)
- `affixes` (list)
- `leaderboard_url` (text)
- `region` (text)
- `title` (text)

**Example output**

```json
{
  "affix_names": [
    "Xal'atath's Bargain: Pulsar",
    "Fortified"
  ],
  "affixes": [
    {
      "description": "Non-boss enemies have 20% more health and inflict up to 20% increased damage.",
      "icon_url": "https://cdn.raiderio.net/images/wow/icons/large/ability_toughness.jpg",
      "id": 10,
      "name": "Fortified",
      "wowhead_url": "https://wowhead.com/affix=10"
    }
  ],
  "leaderboard_url": "https://raider.io/mythic-plus-affix-rankings/season-mn-2/all/us/leaderboards-strict/fortified",
  "region": "us",
  "title": "Xal'atath's Bargain: Pulsar, Fortified, Tyrannical"
}
```

### Get weekly reset time

Get when this week's raid lockouts, affixes and Great Vault reset in a region, and how many hours away that is.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.

**Outputs**

- `hours_until_reset` (number)
- `next_week_ends_at` (text)
- `previous_week_started_at` (text)
- `region` (text)
- `resets_at` (text)
- `week` (number)
- `week_started_at` (text)

**Example output**

```json
{
  "hours_until_reset": 117.0,
  "next_week_ends_at": "2026-10-27T15:00:00Z",
  "previous_week_started_at": "2026-10-06T15:00:00Z",
  "region": "us",
  "resets_at": "2026-10-20T15:00:00Z",
  "week": 1085,
  "week_started_at": "2026-10-13T15:00:00Z"
}
```

### List guild members

List a guild's members, guild master first, with each one's guild rank, class, spec and role. Narrow the list to the top ranks, one class or one role.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Guild name (`guild`, text, required): The guild's name, spaces included. Capital letters don't matter.
- Highest rank number (`max_rank`, number): Only members at this guild rank or above: 0 is the guild master, 1 the rank below, and so on. Leave empty for everyone. From 0 to 9.
- Class (`class_name`, text): Only members of this class. One of: `Death Knight`, `Demon Hunter`, `Druid`, `Evoker`, `Hunter`, `Mage`, `Monk`, `Paladin`, `Priest`, `Rogue`, and 3 more.
- Role (`role`, text): Only members whose current spec plays this role. One of: `tank`, `healer`, `dps` (Damage).

**Outputs**

- `faction` (text)
- `last_updated` (text)
- `member_count` (number)
- `members` (list)
- `name` (text)
- `profile_url` (text)
- `realm` (text)
- `region` (text)
- `total_members` (number)

**Example output**

```json
{
  "faction": "horde",
  "last_updated": "2026-10-15T07:07:29Z",
  "member_count": 1,
  "members": [
    {
      "achievement_points": 12350,
      "class": "Monk",
      "faction": "horde",
      "last_updated": "2026-10-15T00:25:18Z",
      "name": "Glaxqt",
      "profile_url": "https://raider.io/characters/us/illidan/Glaxqt",
      "race": "Orc",
      "rank": 0,
      "rank_name": "Guild Master",
      "realm": "Illidan",
      "region": "us",
      "role": "tank",
      "spec": "Brewmaster"
    }
  ],
  "name": "Liquid",
  "profile_url": "https://raider.io/guilds/us/illidan/Liquid",
  "realm": "Illidan",
  "region": "us",
  "total_members": 964
}
```

### List Mythic+ dungeons

List a Mythic+ season's dungeons with their short names and timers, and when the season starts and ends in a region.

**Inputs**

- Season (`season`, text): The Mythic+ season. 'Current season' always follows the season running now. Default: `current`.
- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.

**Outputs**

- `dungeon_count` (number)
- `dungeon_names` (list)
- `dungeons` (list)
- `ends_at` (text)
- `region` (text)
- `season` (text)
- `season_name` (text)
- `starts_at` (text)

**Example output**

```json
{
  "dungeon_count": 1,
  "dungeon_names": [
    "Altar of Fangs"
  ],
  "dungeons": [
    {
      "icon_url": "https://cdn.raiderio.net/images/wow/icons/large/inv_achievement_dungeon_altaroffangs.jpg",
      "name": "Altar of Fangs",
      "short_name": "AOF",
      "slug": "altar-of-fangs",
      "time_limit": "30:00",
      "time_limit_seconds": 1800
    }
  ],
  "ends_at": null,
  "region": "us",
  "season": "season-mn-2",
  "season_name": "MN Season 2",
  "starts_at": "2026-08-18T15:00:00Z"
}
```

### List Mythic+ runs

List up to ten of a character's Mythic+ runs this season: the most recent, the best for score, or the highest keys this season, this week or last week. Each run has the dungeon, key level, time, whether it was timed, the affixes and a link.

**Inputs**

- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.
- Realm (`realm`, text, required): The realm, picked from the region's list or typed the way the game shows it (Area 52, Kel'Thuzad).
- Character name (`name`, text, required): The character's name. Capital letters don't matter.
- Runs (`runs`, text): Which runs to list. One of: `recent` (Most recent), `best` (Best for score this season), `highest` (Highest keys this season), `this_week` (Highest keys this week), `last_week` (Highest keys last week). Default: `recent`.

**Outputs**

- `class` (text)
- `highest_key_level` (number)
- `list` (text)
- `name` (text)
- `profile_url` (text)
- `realm` (text)
- `region` (text)
- `role` (text)
- `run_count` (number)
- `runs` (list)
- `spec` (text)
- `timed_count` (number)

**Example output**

```json
{
  "class": "Shaman",
  "highest_key_level": 22,
  "list": "recent",
  "name": "Pookiexo",
  "profile_url": "https://raider.io/characters/us/illidan/Pookiexo",
  "realm": "Illidan",
  "region": "us",
  "role": "healer",
  "run_count": 1,
  "runs": [
    {
      "affixes": [
        "Fortified",
        "Tyrannical",
        "Xal'atath's Guile"
      ],
      "clear_time": "30:45",
      "clear_time_seconds": 1845,
      "completed_at": "2026-10-15T06:29:40Z",
      "dungeon": "Murder Row",
      "dungeon_short_name": "MR",
      "dungeon_slug": "murder-row",
      "key_level": 22,
      "keystone_upgrades": 1,
      "role": "healer",
      "run_id": 20714657,
      "score": 518.6,
      "season": "season-mn-2",
      "spec": "Restoration",
      "time_left_seconds": 196,
      "time_limit_seconds": 2041,
      "timed": true,
      "url": "https://raider.io/mythic-plus-runs/season-mn-2/20714657-22-murder-row"
    }
  ],
  "spec": "Restoration",
  "timed_count": 1
}
```

### List raids and bosses

List an expansion's raids, newest first, with their bosses and when each raid opened in a region.

**Inputs**

- Expansion (`expansion`, text): The expansion whose raids to list. One of: `latest` (Newest expansion), `11` (Midnight), `10` (The War Within), `9` (Dragonflight), `8` (Shadowlands), `7` (Battle for Azeroth), `6` (Legion). Default: `latest`.
- Region (`region`, text, required): The World of Warcraft region the realm is in. One of: `us` (Americas & Oceania (US)), `eu` (Europe), `kr` (Korea), `tw` (Taiwan), `cn` (China). Default: `us`.

**Outputs**

- `expansion` (text)
- `expansion_id` (number)
- `raid_count` (number)
- `raids` (list)
- `region` (text)

**Example output**

```json
{
  "expansion": "Midnight",
  "expansion_id": 11,
  "raid_count": 1,
  "raids": [
    {
      "boss_count": 1,
      "bosses": [
        {
          "name": "Ula'tek",
          "slug": "ulatek"
        }
      ],
      "ends_at": null,
      "name": "The Venomous Abyss",
      "short_name": "VA",
      "slug": "the-venomous-abyss",
      "starts_at": "2026-08-18T15:00:00Z"
    }
  ],
  "region": "us"
}
```