---
title: "Retrieve the boss rankings for a given raid and region"
method: GET
path: "/api/v1/raiding/boss-rankings"
tags: ["raiding"]
---

# Retrieve the boss rankings for a given raid and region

`GET /api/v1/raiding/boss-rankings`

## 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.
- `raid` 'the-tidebound-grotto' | 'the-venomous-abyss' | 'sporefall' | 'tier-mn-1' | 'manaforge-omega' | 'liberation-of-undermine' | 'nerubar-palace' | 'blackrock-depths' | 'awakened-amirdrassil-the-dreams-hope' | 'awakened-aberrus-the-shadowed-crucible' | 'awakened-vault-of-the-incarnates' | 'amirdrassil-the-dreams-hope' | 'aberrus-the-shadowed-crucible' | 'vault-of-the-incarnates' | 'fated-sepulcher-of-the-first-ones' | 'fated-sanctum-of-domination' | 'fated-castle-nathria' | 'sepulcher-of-the-first-ones' | 'sanctum-of-domination' | 'castle-nathria' | 'nyalotha-the-waking-city' | 'the-eternal-palace' | 'crucible-of-storms' | 'battle-of-dazaralor' | 'uldir' | 'antorus-the-burning-throne' | 'tomb-of-sargeras' | 'the-nighthold' | 'trial-of-valor' | 'the-emerald-nightmare', required — Raid to look up. This can be the raid's full name ("Sporefall") or its name in slug form: "sporefall"
- `boss` string, required — Slug of boss to look up
- `difficulty` 'mythic' | 'heroic' | 'normal', required — One of: mythic, heroic, normal
- `region` string, 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` string — 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.

## Response `200`

Successful

- ViewBossRankingsResponse
  - `bossRankings` BossRankingEntry[] — Ranked guilds for this boss
    - `guild` RaidingGuild
      - `id` integer — Guild ID
      - `name` string — Guild name
      - `faction` string
      - `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 — URL path to guild profile
      - `logo` string, nullable — Guild logo URL
      - `color` string — Guild brand color
      - `isDefaultLogo` boolean
      - `displayName` string
    - `rank` integer — Overall rank
    - `regionRank` integer, nullable — Region-specific rank
    - `encountersDefeated` EncounterDefeated[]
      - `slug` string
      - `firstDefeated` string, nullable
      - `lastDefeated` string, nullable
    - `isAttemptOnly` boolean — Whether this row represents best-pull progress before a boss kill
    - `bestPercent` number, nullable — Best overall health % reached on this boss (0-100) for attempt-only rows
    - `progressDisplay` string, nullable — Human-readable attempt progress for attempt-only rows
    - `pullCount` integer, nullable — Visible pull count for attempt-only rows
    - `lastPulledAt` string, nullable — Most recent visible pull timestamp for attempt-only rows
    - `doesVideoExist` boolean
    - `itemLevelAvg` number, nullable — Average item level
    - `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
    - `streamers` Streamers — Active streamers for this guild
      - `count` integer — Number of active streamers
      - `stream` Stream1, nullable — Featured or top stream
        - `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

---

[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/4c612ac925bb/schema)