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

# Retrieve the raid rankings for a given raid and region

`GET /api/v1/raiding/raid-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"
- `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.
- `guilds` string — Guild IDs of guilds to restrict the results to. Allows filtering to up to 10 different guilds.
- `limit` integer
- `page` integer

## Response `200`

Successful

- ViewRaidRankingsResponse
  - `raidRankings` RaidRankingEntry[] — Ranked guilds
    - `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
    - `encountersPulled` RaidRankingEncounter[]
      - `id` integer
      - `slug` string
      - `isDefeated` boolean
      - `numPulls` integer
      - `pullStartedAt` string
      - `bestPercent` number, nullable
    - `encountersDefeated` EncounterDefeated[]
      - `slug` string
      - `firstDefeated` string, nullable
      - `lastDefeated` string, nullable
    - `guildPrivacy` GuildPrivacy
      - `raidPulls` boolean
      - `raidPercents` boolean
      - `raidComps` boolean
      - `wereRaidPullsRestricted` boolean
      - `wereRaidPercentsRestricted` boolean
      - `wereRaidCompsRestricted` boolean
      - `shareRaidUntil` string, nullable

---

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