---
title: "Retrieve details of raiding progression for a raid, showing how many guilds have reached each boss kill milestone"
method: GET
path: "/api/v1/raiding/progression"
tags: ["raiding"]
---

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

`GET /api/v1/raiding/progression`

## Query parameters

- `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 — Raid difficulty. One of: mythic, heroic, normal
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn' | 'world', required — Name of region to restrict progress to. Can be one of: world, us, eu, kr, tw

## Response `200`

Successful

- ViewRaidProgressionResponse
  - `progression` RaidRaceProgressionEntry[] — Progression entries, one per boss kill count threshold
    - `progress` integer, required — How many bosses out of all bosses in this instance
    - `totalGuilds` integer, required — The number of guilds that are at this point of progression
    - `guilds` GuildDefeatEntry[]
      - `defeatedAt` string, required
      - `guild` GuildSummary
        - `id` integer, required — Internal Raider.IO ID number for this guild
        - `name` string, required — Name of the guild
        - `faction` 'horde' | 'alliance', required
        - `realm` RealmSummary
          - `id` integer, required — Internal Raider.IO ID number for this realm
          - `connectedRealmId` integer, required — Internal connected-realm ID used by Raider.IO
          - `wowRealmId` integer, nullable, required — Blizzard realm ID, or null when unavailable
          - `wowConnectedRealmId` integer, nullable, required — Blizzard connected-realm ID, or null when unavailable
          - `name` string, required — Name of the realm
          - `altName` string, nullable, required — Alternate display name for the realm
          - `slug` string, required — Slug for the realm, suitable for putting in URLs
          - `altSlug` string, required — Alternate slug for the realm
          - `locale` string, nullable, required — Locale configured for the realm
          - `isConnected` boolean, required — Whether the realm is part of a connected realm
          - `realmType` string, required — Realm type summary
        - `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, required — Relative path to the guild profile
        - `logo` string — Guild logo URL
        - `isDefaultLogo` boolean — Whether the guild is using the default logo
        - `color` string — Guild theme color when customized
        - `displayName` string, required — Display name for the guild
        - `alt_name` string — Alternate guild name extracted from the stored name

---

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