/api/v1/periods

Retrieve the current, previous, and next period ids and date ranges

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

/api/v1/characters/profile

Retrieve information about a character.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up character in. Can be one of: us, eu, kr, tw
• realm (query, required) — Name of realm that character is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
• name (query, required) — Name of the character to look up. This is not case sensitive.
• fields (query) — Comma separated list of fields to retrieve for this character. General fields: - gear : retrieve high level item information for player - talents : retrieve talent and loadout information for player - talents:categorized : retrieve talent and loadout information for player, separated into class and spec talents - guild : retrieve basic information about guild the player is in - covenant : retrieve the covenant and renown level of the player Raiding fields: - raid_progression : retrieve raid progression data for character. Defaults to Current Expansion. Can add one or more parameters to request specific raids. e.g.: raid_progression:9 would return all of Dragonflight, or raid_progression:nerubar-palace would return just Nerubar Palace. You can also specify :current-expansion, :previous-expansion, :current-tier, or :previous-tier. See the raiding/static-data endpoint for slugs, and expansion ids. Mythic Plus fields: - mythic_plus_scores_by_season : retrieve scores by mythic plus season. You can specify one or more season by appending multiple ': ' values to this field. You can also use the alias 'current' and 'previous' instead of a season name to request that relative season. For example: mythic_plus_scores_by_season:current will request the current season using mythic_plus_scores_by_season:season-tww-1:season-df-4 will return both seasons. Not specifying a season will default to the current season. Note: Results are returned in an array that matches the order of the seasons in the request. - mythic_plus_ranks : retrieve current season mythic plus rankings for player. - mythic_plus_recent_runs : retrieve ten most recent mythic plus runs for player (current season only). - mythic_plus_best_runs : retrieve ten most high scoring mythic plus runs for player (current season only). Specify the paramater :all to retrieve all of a character's best runs for the season. - mythic_plus_alternate_runs : retrieve ten most high scoring mythic plus alternate runs for player (current season only). Specify the paramater :all to retrieve all of a character's alternate runs for the season. This is available starting Shadowlands Season 1 Post. - mythic_plus_highest_level_runs : retrieve the player's ten highest Mythic+ runs by Mythic+ level (current season only) - mythic_plus_weekly_highest_level_runs : retrieve the player's ten highest Mythic+ runs by Mythic+ level for the current raid week (current season only) - mythic_plus_previous_weekly_highest_level_runs : retrieve the player's ten highest Mythic+ runs by Mythic+ level for the previous raid week (current season only) - mythic_plus_dungeon_run_counts : retrieve the number of runs (total and timed) the player has completed for each dungeon in the season's dungeon pool, zero-filled for dungeons without runs. Defaults to the current season; append ':<season-slug>' to request a specific season, e.g. mythic_plus_dungeon_run_counts:season-tww-1. - previous_mythic_plus_ranks : retrieve mythic plus rankings for player. Other fields: - raid_achievement_meta : retrieve raid achievement meta status for a player. This request requires that you specify parameters for the specific tiers you're looking for. For example if you add ':tier21' to the field you will get the status of Tier 21's meta. Multiple tiers can be added to a single request: ':tier21:tier20:tier19'. - raid_achievement_curve : retrieve AOTC/Cutting Edge achievement status for a given raid slug (or multiple). Multiple slugs can be specified by separating them by colons.

/api/v1/client/character-rivals

Rivals leaderboard window (self +/- 2) around a character. Defaults to the class leaderboard; pass specId for the spec leaderboard.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up character in. Can be one of: us, eu, kr, tw
• realm (query, required) — Name of realm that character is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
• name (query, required) — Name of the character to look up. This is not case sensitive.
• scope (query) — Scope of the rivals leaderboard. One of: realm, region, world
• specId (query) — Optional spec ID. When provided, ranks on that spec's leaderboard; otherwise defaults to the character's class leaderboard.

/api/v1/client/guild-rivals

Active-raid discovery and exact five-row guild leaderboard window for the character Overview dashboard

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• guildId (query, required) — Current guild ID
• scope (query) — Shared geographic scope for every active raid block
• raid (query) — Selected active raid slug
• difficulty (query) — Selected difficulty for the requested raid

/api/v1/client/run-review

Aggregate review payload for a completed Mythic+ run: Keystone Pace, past dungeon runs, and nearby spec leaderboard rivals

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up character in. Can be one of: us, eu, kr, tw
• realm (query, required) — Name of realm that character is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
• name (query, required) — Name of the character to look up. This is not case sensitive.
• dungeonId (query, required) — Raider.IO dungeon ID the run was completed in
• keyLevel (query, required) — Mythic keystone level of the completed run
• clearTimeMs (query, required) — Clear time of the completed run in milliseconds
• affixes (query) — Comma separated affix IDs for the completed run. Used to derive the affix-adjusted timer when the canonical run is not indexed yet.
• itemLevelMean (query) — Observed average item level of the completed run group, used for exact-bracket ILVL Pace
• scope (query) — Scope of the rivals spec leaderboard. One of: realm, region, world
• specId (query) — Spec ID for the rivals leaderboard. Defaults to the character's most-played spec for this dungeon, falling back to their active spec
• completedAt (query) — ISO 8601 completion timestamp of the run. Scopes the historical standing to the run's weekly period; defaults to now (current period) when omitted. Historical runs MUST send their real completion time. A malformed value degrades only the historical standing (it never fails the request).

/api/v1/guilds/boss-kill

Retrieve information about a guild boss kill.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up guild in. Can be one of: us, eu, kr, tw
• realm (query, required) — Name of realm that guild is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
• guild (query, required) — Name of the guild to look up. This is not case sensitive.
• raid (query, required) — Raid slug to look up
• boss (query, required) — Boss slug to look up
• difficulty (query, required) — Raid difficulty to look up

/api/v1/guilds/profile

Retrieve information about a guild.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up guild in. Can be one of: us, eu, kr, tw
• realm (query, required) — Name of realm that guild is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
• name (query, required) — Name of the guild to look up. This is not case sensitive.
• fields (query) — Comma separated list of fields to retrieve for this guild. Supported values: - raid_progression : retrieve raid progression data for guild. This can optionally take parameters to control what raids you are getting data for. These parameters can be numeric expansion IDs, specific raid slugs, or the terms "current-expansion", "previous-expansion", "current-tier", or "previous-tier". - raid_rankings : retrieve raid rankings data for guild. This can optionally take parameters to control what raids you are getting data for. These parameters can be numeric expansion IDs, specific raid slugs, or the terms "current-expansion", "previous-expansion", "current-tier", or "previous-tier". - raid_encounters:RAID_SLUG:DIFFICULTY : retrieve details on which encounters were defeated from a specific raid and difficulty - members : retrieve guild members details

/api/v1/mythic-plus/affixes

Retrieve the affixes for a specific region, including the latest run seen with this affix

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up affixes for. Can be one of: us, eu, kr, tw
• locale (query) — Language to return name and description of affixes in. Can be one of: en, ru, ko, cn, pt, it, fr, es, de, tw

/api/v1/mythic-plus/cutoff-analysis

Retrieve cached Mythic+ cohort cutoff history and forecasts

• access_key (query)
• season (query, required)
• region (query, required)
• faction (query)
• category (query, required)
• percentile (query)
• percentiles (query)
• cohort (query)
• targetDate (query)
• density (query)
• forecastHistory (query)

/api/v1/mythic-plus/leaderboard-capacity

Retrieve the leaderboard capacity for a region including lowest level and time to qualify

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• scope (query) — Retrieve the capacity info for the current or previous week. Supported values: current and previous .
• region (query, required) — Name of region to retrieve runs for. Can be one of: world, us, eu, kr, tw
• realm (query)

/api/v1/mythic-plus/run-details

Retrieve details for a specific Mythic+ run

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query, required) — Name of the season to retrieve (season-mn-2, etc.). Defaults to current season.
• id (query, required) — ID of the run that you want to get details for

/api/v1/mythic-plus/runs

Retrieve information about the top runs that match the given criteria

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query) — Name of season to request data for
• region (query) — Name of region to retrieve runs for. Can be one of: world, us, eu, kr, tw
• dungeon (query) — Name of dungeon to filter by. This can be the dungeon's full name "Eye of Azshara" or its slug "eye-of-azshara". Use special keyword "all" to get the stats across all dungeons.
• affixes (query) — Name of the affixes to restrict the results to. This will support affix in slug form: "bolstering-explosive-tyrannical". Additionally, you can supply just "tyrannical" or "fortified" to get the results for any affix combo with that as the final affix. Use the special keyword "current" to return the result for the current week's affixes, or "all" to retrieve results for all affixes.
• page (query, page) — Page of results to return. Limited to 100 pages by default, can be increased with access key to 1000.

/api/v1/mythic-plus/score-tiers

Retrieve the colors used for score tiers in the given season.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query) — Name of the season to retrieve (season-mn-2, etc.). Defaults to current season.

/api/v1/mythic-plus/season-cutoffs

Retrieve the Mythic+ Season cutoffs for a region

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query) — Season to retrieve cutoffs for
• region (query, required) — Region to receive cutoffs for

/api/v1/mythic-plus/static-data

Retrieve mythic plus season and dungeon static data for a specific expansion (slugs, names, etc.)

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• expansion_id (query, required) — Expansion ID. 11 = Midnight, 10 = TheWarWithin, 9 = Dragonflight, 8 = Shadowlands, 7 = BattleForAzeroth, 6 = Legion

/api/v1/raiding/boss-rankings

Retrieve the boss rankings for a given raid and region

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid to look up. This can be the raid's full name ("The Venomous Abyss") or its name in slug form: "the-venomous-abyss"
• boss (query, required) — Slug of boss to look up
• difficulty (query, required) — One of: mythic, heroic, normal
• region (query, required) — Name of region to restrict progress to. Can be a primary region: world, us, eu, kr, tw. Or a subregion: english, french, german, italian, oceanic, russian, spanish, eu-english, eu-portuguese, eu-spanish, us-english, brazil, us-spanish, us-central, us-eastern, us-mountain, us-pacific
• realm (query) — Name of realm to restrict to. Prefix with `connected-` to retrieve rankings from the connected realm. Requires that region be a standard region: us, eu, kr, tw.

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

Retrieve the hall of fame for a given raid

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• region (query, required) — Name of region to restrict progress to. Can be one of: world, us, eu, kr, tw

/api/v1/raiding/progression

Retrieve details of raiding progression for a raid, showing how many guilds have reached each boss kill milestone

• raid (query, required) — Raid to look up. This can be the raid's full name ("The Venomous Abyss") or its name in slug form: "the-venomous-abyss"
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• region (query, required) — Name of region to restrict progress to. Can be one of: world, us, eu, kr, tw

/api/v1/live-tracking/mythic-plus/current-dungeon

Retrieve the dungeon a Mythic+ team or platoon is currently running, if any. Returns null dungeon when no active run is detected.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query, required) — Season to look up. This is the season name in slug form: "season-mn-2"
• teamId (query) — Team ID to look up
• platoonId (query) — PlatoonID to look up

/api/v1/raiding/raid-rankings

Retrieve the raid rankings for a given raid and region

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid to look up. This can be the raid's full name ("The Venomous Abyss") or its name in slug form: "the-venomous-abyss"
• difficulty (query, required) — One of: mythic, heroic, normal
• region (query, required) — Name of region to restrict progress to. Can be a primary region: world, us, eu, kr, tw. Or a subregion: english, french, german, italian, oceanic, russian, spanish, eu-english, eu-portuguese, eu-spanish, us-english, brazil, us-spanish, us-central, us-eastern, us-mountain, us-pacific
• realm (query) — Name of realm to restrict to. Prefix with `connected-` to retrieve rankings from the connected realm. Requires that region be a standard region: us, eu, kr, tw.
• guilds (query) — Guild IDs of guilds to restrict the results to. Allows filtering to up to 10 different guilds.
• limit (query, limit)
• page (query, page)

/api/v1/raiding/static-data

Retrieve raid and boss static data for a specific expansion (slugs, names, etc.)

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• expansion_id (query, required) — Expansion ID. 11 = Midnight, 10 = TheWarWithin, 9 = Dragonflight, 8 = Shadowlands, 7 = BattleForAzeroth, 6 = Legion

/api/v1/live-tracking/character/loadout

Retrieve a character loadout snapshot from combat log data, including equipped gear, spec, and basic profile info.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• region (query, required) — Name of region to look up character in. Can be one of: us, eu, kr, tw
• realm (query, required) — Name of realm that character is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
• name (query, required) — Name of the character to look up. This is not case sensitive.

/api/v1/live-tracking/guild/boss-attempts

Retrieve a simplified timeline of boss attempts with health percentages. Ideal for rendering progress-over-time charts and stream overlays.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• boss (query, required) — Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• region (query, required) — Region of the guild. One of: us, eu, kr, tw
• realm (query, required) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
• guild (query, required) — Guild name. Not case sensitive.
• period (query) — Lockout period. One of: "current", "until_kill", "all", or an integer period ID.

/api/v1/live-tracking/guild/boss-progress

Retrieve a guild's best progress on a specific boss, including best health percentage, total pull count, and kill status. Ideal for progress widgets and stream overlays.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• boss (query, required) — Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• period (query) — Lockout period. One of: "current", "until_kill", "all", or an integer period ID.
• guild_id (query) — Raider.IO guild ID. Alternative to the region/realm/guild parameters.
• region (query) — Region to filter by. One of: world, us, eu, kr, tw Required if guild_id not provided.
• realm (query) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms") Required if guild_id not provided.
• guild (query) — Guild name. Not case sensitive. Required if guild_id not provided.

/api/v1/live-tracking/rwf-event/feed

Retrieve a Race to World First event feed (kills, best percents, new pulls) for tracked guilds. Supports real-time polling via the "after" cursor parameter.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• types (query) — Comma-separated list of event types to include. Valid values: best_percent, new_boss, boss_kill
• guild_ids (query, required) — Comma-separated list of Raider.IO guild IDs to track.
• border_style (query) — Border style variant for event card rendering
• after (query, required) — Cursor: only return events with an ID greater than this value. Use 0 to fetch all, or the last seen event ID for polling.
• test (query) — If set, return test/mock event data

/api/v1/live-tracking/guild/boss-pulls

Retrieve detailed pull history for a specific boss including wipe/kill status, health percentages, and duration. Supports filtering by lockout period and date range.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• boss (query, required) — Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• region (query, required) — Region of the guild. One of: us, eu, kr, tw
• realm (query, required) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
• guild (query, required) — Guild name. Not case sensitive.
• period (query) — Lockout period. One of: "current", "until_kill", "all", or an integer period ID.
• min_date (query) — Skip pulls before this date (ISO 8601)
• max_date (query) — Skip pulls after this date (ISO 8601)

/api/v1/live-tracking/guild/gear-summary

Retrieve a gear summary for a guild roster. Supports two scopes: "pull" uses combat log data from raid encounters, "armory" uses the latest Blizzard armory snapshot.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• difficulty (query) — Raid difficulty. One of: mythic, heroic, normal. Optional filter.
• scope (query) — Data source scope. "pull" uses combat log data from raid pulls. "armory" uses the latest armory snapshot.
• advanced_search (query) — Enable advanced search mode with additional filtering options
• before_date (query) — For "pull" scope only: only consider pulls before this date (ISO 8601)
• boss (query) — For "pull" scope only: request data from a specific boss slug
• first_kill (query) — For "pull" scope only: only show data from up to the first kill
• period (query) — For "pull" scope only: request data from a specific lockout period. 0 = all periods.
• pull_id (query) — For "pull" scope only: the ID of the pull to look up. You can get this from a raid-pulls call. Setting to 0 will fetch the latest from the guild.
• guild_id (query) — Raider.IO guild ID. Alternative to the region/realm/guild parameters.
• region (query) — Region to filter by. One of: world, us, eu, kr, tw Required if guild_id not provided.
• realm (query) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms") Required if guild_id not provided.
• guild (query) — Guild name. Not case sensitive. Required if guild_id not provided.

/api/v1/live-tracking/guild/ilvl-history

Retrieve a guild's average item level over time during a raid tier, reconstructed from armory and combat-log observations for the top N geared roster characters. Optionally overlay the logged per-pull raid group item level.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• top_n (query) — How many of the highest geared eligible roster characters to average
• difficulty (query) — Raid difficulty. One of: mythic, heroic, normal. 'latest' resolves per guild to their highest difficulty with kills.
• include_pulls (query) — Also return the logged per-pull raid group item level averages
• pulls_difficulty (query) — Comma separated difficulties the pull overlay covers, e.g. `heroic,mythic`. Defaults to `all`, so split runs on a lower difficulty than the tracked progression still show up
• pulls_scope (query) — Which logged raids the pull overlay covers: 'cohort' keeps only raids one of the tracked top-N characters was in, 'all' keeps every raid any guild member was in
• bucket (query) — Sampling interval of the item level series; auto-promoted on long windows
• scope (query) — Which roster characters to sample: every eligible character, or mains only
• min_date (query) — Clamp the window start to this date (ISO 8601)
• max_date (query) — Clamp the window end to this date (ISO 8601)
• region (query, required) — Region of the guild. One of: us, eu, kr, tw
• realm (query, required) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
• guild (query, required) — Guild name. Not case sensitive.

/api/v1/live-tracking/guild/loot

Retrieve recent loot drops for a guild from combat log data. Filterable by time range and item type.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• region (query, required) — Region of the guild. One of: us, eu, kr, tw
• realm (query, required) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
• guild (query, required) — Guild name. Not case sensitive.
• duration_minutes (query) — Look back window in minutes from now. Default: 10.
• start_time (query) — Explicit start time for the loot window (ISO 8601). Overrides duration_minutes.
• end_time (query) — Explicit end time for the loot window (ISO 8601). Defaults to now.
• count (query, limit) — Maximum number of loot items to return. 0 = no limit.
• item_types (query) — Comma-separated list of item types to filter by. Valid values: all, allbutconduits, tier, weapon, trinket. Empty = all types.

/api/v1/live-tracking/rwf-event/last

Retrieve the latest event ID for a Race to World First raid. Use the returned ID as the "after" cursor in the feed endpoint to poll for new events.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")

/api/v1/mythic-plus/cutoff-analysis/seasons

Published season and region cutoff datasets

/api/v1/mythic-plus/cutoff-analysis/summary

Published Mythic+ score cutoffs, character populations and daily history

• access_key (query)
• season (query, required)
• region (query, required)
• format (query)

/api/v1/live-tracking/guild/raid-comps

Retrieve raid composition details for a specific pull, including the full roster with character specs, gear, and talents.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• difficulty (query) — Raid difficulty. One of: mythic, heroic, normal. Optional filter.
• id (query) — The ID of the pull to look up. You can get this from a raid-pulls call. Setting to 0 will fetch the latest from the guild.
• guild_id (query) — Raider.IO guild ID. Alternative to the region/realm/guild parameters.
• region (query) — Region to filter by. One of: world, us, eu, kr, tw Required if id == 0.
• realm (query) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms") Required if id == 0.
• boss (query) — Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
• guild (query) — Guild name. Not case sensitive. Required if id == 0.

/api/v1/live-tracking/guild/raid-progress

Retrieve overall raid progress for a guild across all bosses. Returns best percent, pull count, and kill status for every encounter in the raid.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• guild_id (query) — Raider.IO guild ID. Alternative to the region/realm/guild parameters.
• region (query) — Region of the guild. One of: us, eu, kr, tw
• realm (query) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
• guild (query) — Guild name. Not case sensitive.
• period (query) — Lockout period. One of: "current", "until_kill", "all", or an integer period ID.

/api/v1/live-tracking/guild/raid-pulls

Retrieve pull counts and details for each boss encounter. Returns all encounters with pull history for the specified guild, raid, and difficulty.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• period (query) — The integer period to show pulls from. If not supplied will show across all periods
• start_range (query) — The start range of attempts (ISO 8601)
• end_range (query) — The end range of attempts (ISO 8601)
• region (query) — Region to filter by. One of: world, us, eu, kr, tw
• realm (query) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
• guild (query) — Guild name. Not case sensitive.
• guild_id (query) — Raider.IO guild ID. Alternative to the region/realm/guild parameters.

/api/v1/live-tracking/heatmaps/floors

Retrieve floor geometry data for all dungeons. Used to map game-world coordinates onto dungeon map images for heatmap rendering.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

/api/v1/live-tracking/heatmaps/grid

Query aggregated spatial heatmap data for Mythic+ dungeons. Returns density data (deaths, spell casts) bucketed into a floor grid. Supports filtering by key level, item level, specs, classes, affixes, and more.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• type (query, required) — Heatmap data type. One of: npc_death, player_death, player_spell
• challengeModeId (query, required) — Challenge mode ID of the dungeon to query
• season (query, required) — Mythic+ season slug (e.g. "season-mn-2")
• dataType (query) — Coordinate source. "player_position" uses the dying player/casting player coords; "enemy_position" uses the NPC coords.
• region (query) — Region to filter runs by (e.g. "us", "eu"). Omit for all regions.
• minMythicLevel (query) — Minimum Mythic+ key level to include
• maxMythicLevel (query) — Maximum Mythic+ key level to include
• minItemLevel (query) — Minimum average group item level to include
• maxItemLevel (query) — Maximum average group item level to include
• minPeriod (query) — Minimum lockout period ID to include
• maxPeriod (query) — Maximum lockout period ID to include
• minTimerFraction (query) — Minimum timer fraction (0 = depleted at 0%, 1 = exactly on time). Filters runs by relative completion speed.
• maxTimerFraction (query) — Maximum timer fraction. Default: 1 (on time or faster).
• minPlayerDeaths (query) — Minimum total player deaths in the run
• maxPlayerDeaths (query) — Maximum total player deaths in the run
• includeSpecIds (query) — Comma-separated spec IDs. Only include runs where at least one player had one of these specs.
• excludeSpecIds (query) — Comma-separated spec IDs. Exclude runs where any player had one of these specs.
• includeClassIds (query) — Comma-separated class IDs. Only include runs where at least one player had one of these classes.
• excludeClassIds (query) — Comma-separated class IDs. Exclude runs where any player had one of these classes.
• excludePlayerDeathSpecIds (query) — player_death only: comma-separated spec IDs. Exclude deaths from players with these specs.
• includePlayerDeathSpecIds (query) — player_death only: comma-separated spec IDs. Only include deaths from players with these specs.
• excludePlayerDeathClassIds (query) — player_death only: comma-separated class IDs. Exclude deaths from players with these classes.
• includePlayerDeathClassIds (query) — player_death only: comma-separated class IDs. Only include deaths from players with these classes.
• includePlayerSpellIds (query) — player_spell only: comma-separated spell IDs. Only include casts of these spells.
• includeAffixIds (query) — Comma-separated affix IDs. Only include runs with at least one of these affixes active.
• excludeAffixIds (query) — Comma-separated affix IDs. Exclude runs with any of these affixes active.
• minRequiredSamplesFactor (query) — Minimum sample density factor (0-1). Filters out grid cells below this threshold relative to the most populated cell.
• floorsAsArray (query) — If true, return floors as an array instead of an object keyed by floor ID
• token (query) — Encoded token containing pre-set filter parameters (e.g. from season recap heatmaps)

/api/v1/live-tracking/guild/ilvl-history/batch

Retrieve item level history for up to 10 guilds in one comparison request.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• top_n (query) — How many of the highest geared eligible roster characters to average
• difficulty (query) — Raid difficulty. One of: mythic, heroic, normal. 'latest' resolves per guild to their highest difficulty with kills.
• include_pulls (query) — Also return the logged per-pull raid group item level averages
• pulls_difficulty (query) — Comma separated difficulties the pull overlay covers, e.g. `heroic,mythic`. Defaults to `all`, so split runs on a lower difficulty than the tracked progression still show up
• pulls_scope (query) — Which logged raids the pull overlay covers: 'cohort' keeps only raids one of the tracked top-N characters was in, 'all' keeps every raid any guild member was in
• bucket (query) — Sampling interval of the item level series; auto-promoted on long windows
• scope (query) — Which roster characters to sample: every eligible character, or mains only
• min_date (query) — Clamp the window start to this date (ISO 8601)
• max_date (query) — Clamp the window end to this date (ISO 8601)
• guilds (query, required) — Up to 10 region/realm/guild paths separated by |

/api/v1/live-tracking/raiding/bot-commands/{cmd}

Return a pre-formatted string for use in Twitch/Discord bot commands. Supports template variables ($PCT, $BOSS, $PULL, $DIFFICULTY) for custom formatting.

• cmd (path, required) — Bot command to execute. One of: best-percent, pull-count, percent-and-pulls, itemlevel
• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• boss (query, required) — Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
• difficulty (query, required) — Raid difficulty. One of: mythic, heroic, normal
• period (query) — Lockout period. One of: "current", "until_kill", "all", or an integer period ID.
• guild_id (query) — Raider.IO guild ID. Alternative to the region/realm/guild parameters.
• region (query) — Region to filter by. One of: world, us, eu, kr, tw Required if guild_id not provided.
• realm (query) — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms") Required if guild_id not provided.
• guild (query) — Guild name. Not case sensitive. Required if guild_id not provided.
• template (query) — Template to use for formatting results. You can put in special replacement values: $PCT, $BOSS, $PULL, $DIFFICULTY

/api/v1/live-tracking/user/activities/mythic-plus

Retrieve Mythic+ combat log contribution activities for a user in a given season.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query, required) — Mythic+ season slug (e.g. "season-mn-2")
• user_id (query, required) — Raider.IO user ID to retrieve activities for
• types (query, required) — Comma-separated list of activity types to include. Valid values: MPLUS_ENCOUNTER_START, MPLUS_ENCOUNTER_END, MPLUS_DUNGEON_START, MPLUS_DUNGEON_END, MPLUS_ZONE_CHANGE

/api/v1/live-tracking/user/activities/raiding

Retrieve raiding combat log contribution activities for a user in a given raid.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• user_id (query, required) — Raider.IO user ID to retrieve activities for
• types (query, required) — Comma-separated list of activity types to include. Valid values: RAID_ENCOUNTER_START, RAID_ENCOUNTER_END

/api/v1/live-tracking/user/activity/mythic-plus

Retrieve detailed information about a specific Mythic+ run from combat log data, including roster, dungeon, timing, and performance.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• season (query, required) — Mythic+ season slug (e.g. "season-mn-2")
• run_id (query, required) — Keystone run ID to retrieve details for

/api/v1/live-tracking/user/activity/raiding

Retrieve detailed information about a specific raid encounter from combat log data.

• access_key (query) — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
• raid (query, required) — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
• encounter_id (query, required) — Raid encounter ID to retrieve details for