v4

OpenAPI 3.0.02026-07-3137328230.2 KB
mythic_plus

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

get/api/v1/client/run-review

Query parameters

access_keystring

The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

region'us' | 'eu' | 'tw' | 'kr' | 'cn' required

Name of region to look up character in. Can be one of: us, eu, kr, tw

Name of region to look up character in. Can be one of: us, eu, kr, tw

realmstring 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 of realm that character is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"

namestring required

Name of the character to look up. This is not case sensitive.

Name of the character to look up. This is not case sensitive.

dungeonIdinteger required

Raider.IO dungeon ID the run was completed in

Example:6988

Raider.IO dungeon ID the run was completed in

keyLevelinteger required

Mythic keystone level of the completed run

Mythic keystone level of the completed run

clearTimeMsinteger required

Clear time of the completed run in milliseconds

Clear time of the completed run in milliseconds

affixesstring

Comma separated affix IDs for the completed run. Used to derive the affix-adjusted timer when the canonical run is not indexed yet.

Example:10,152

Comma separated affix IDs for the completed run. Used to derive the affix-adjusted timer when the canonical run is not indexed yet.

itemLevelMeannumber

Observed average item level of the completed run group, used for exact-bracket ILVL Pace

Observed average item level of the completed run group, used for exact-bracket ILVL Pace

scope'realm' | 'region' | 'world'

Scope of the rivals spec leaderboard. One of: realm, region, world

Scope of the rivals spec leaderboard. One of: realm, region, world

specIdinteger

Spec ID for the rivals leaderboard. Defaults to the character's most-played spec for this dungeon, falling back to their active spec

Spec ID for the rivals leaderboard. Defaults to the character's most-played spec for this dungeon, falling back to their active spec

completedAtstring

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).

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).

Response

Successful

percentilenumber nullable required

Current Pace: worldwide percentile of this clear time within the latest published whole-season population for the dungeon and key level.

historicalPercentilenumber nullable required

Historical Pace: worldwide percentile of this clear time within the run's published weekly population; null when unavailable or too thin.

historicalLockedboolean required

Whether the Historical Pace period is finalized in the active materialization.

runScorenumber nullable required

Run score derived from keyLevel, clearTimeMs, and the canonical or affix-adjusted dungeon timer