---
title: "Retrieve information about the top runs that match the given criteria"
method: GET
path: "/api/v1/mythic-plus/runs"
tags: ["mythic_plus"]
---

# Retrieve information about the top runs that match the given criteria

`GET /api/v1/mythic-plus/runs`

## Query parameters

- `access_key` string — The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
- `season` string — Name of season to request data for
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn' | 'world' — Name of region to retrieve runs for. Can be one of: world, us, eu, kr, tw
- `dungeon` string — 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` string — 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` integer — Page of results to return. Limited to 100 pages by default, can be increased with access key to 1000.

## Response `200`

Successful

- ViewMythicPlusRunsResponse
  - `rankings` RankedRun[] — List of ranked runs
    - `rank` integer — Rank position
    - `score` number — Score for the run
    - `run` RankedRunDetail
      - `season` string — Season slug
      - `status` string — Run status
      - `dungeon` RunDungeonSummary
        - `id` integer
        - `name` string
        - `short_name` string
        - `slug` string
        - `expansion_id` integer
        - `icon_url` string
        - `keystone_timer_ms` integer
        - `map_challenge_mode_id` integer
        - `num_bosses` integer
        - `patch` string
        - `type` string
        - `wowInstanceId` integer
        - `group_finder_activity_ids` integer[]
      - `keystone_run_id` integer — Unique run ID
      - `mythic_level` integer — Keystone level
      - `clear_time_ms` integer — Clear time in ms
      - `keystone_time_ms` integer — Timer for the dungeon in ms
      - `completed_at` string — When the run was completed
      - `deleted_at` string, nullable
      - `num_chests` integer — Number of upgrades earned
      - `time_remaining_ms` integer — Time remaining in ms
      - `faction` string — Faction of the group
      - `weekly_modifiers` RunAffix[] — Active affixes
        - `id` integer
        - `name` string
        - `description` string
        - `icon` string
        - `slug` string
      - `num_modifiers_active` integer
      - `keystone_team_id` integer, nullable
      - `keystone_platoon_id` integer, nullable
      - `logged_run_id` integer, nullable
      - `platoon` Platoon, nullable — Platoon info if applicable
      - `videos` Video[] — Associated video recordings
        - `type` string — Video platform (e.g. youtube)
        - `id` string — Platform-specific video ID
      - `roster` RunsRosterMember[] — Run roster
        - `character` Character2
          - `id` integer
          - `persona_id` integer
          - `name` string
          - `class` Class
            - `id` number
            - `name` string
            - `slug` string
          - `spec` Spec3
            - `id` number
            - `name` string
            - `slug` string
            - `role` string
          - `race` Race
            - `id` number
            - `name` string
            - `slug` string
            - `faction` string
          - `faction` string
          - `level` integer
          - `realm` FullRealm
            - `id` integer
            - `name` string
            - `slug` string
            - `altName` string, nullable
            - `altSlug` string
            - `locale` string
            - `isConnected` boolean
            - `connectedRealmId` integer
            - `realmType` string
            - `wowRealmId` integer
            - `wowConnectedRealmId` integer
          - `region` RegionSummary
            - `name` string, required — Name of the region
            - `short_name` string, required — Short name of the region
            - `slug` string, required — Slug for the region, suitable for putting in URLs
          - `path` string
          - `stream` Stream, nullable — Active stream info
            - `is_featured_stream` boolean
            - `activity_record_id` integer
            - `id` string — Stream ID
            - `name` string — Streamer username
            - `user_id` string
            - `game_id` string
            - `type` string — Stream status (e.g. live)
            - `title` string
            - `community_ids` string[]
            - `viewer_count` integer
            - `started_at` string
            - `language` string
            - `thumbnail_url` string
          - `recruitmentProfiles` RecruitmentProfile[]
            - `activity_type` string — Type of recruitment activity (e.g. guild_raids)
            - `entity_type` string — Entity type (e.g. guild)
            - `recruitment_profile_id` integer — Recruitment profile ID
          - `flags` Flags, nullable — Character flags
        - `role` string
        - `oldCharacter` OldCharacter, nullable — Previous character info if transferred
        - `isTransfer` boolean
        - `isBanned` boolean
  - `leaderboard_url` string — URL to the leaderboard on Raider.IO
  - `params` Params — Echo of the query parameters used
    - `season` string
    - `region` string
    - `dungeon` string
    - `access_key` string
    - `page` integer

---

[API](https://skmtc.net/raider/apis/raider-io-developer-api.md) · [All operations](https://skmtc.net/raider/apis/raider-io-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/raider/raider-io-developer-api/revisions/d89777d7faee/schema)