---
title: "Retrieve raid composition details for a specific pull, including the full roster with character specs, gear, and talents."
method: GET
path: "/api/v1/live-tracking/guild/raid-comps"
tags: ["Live Tracking - Raiding"]
---

# Retrieve raid composition details for a specific pull, including the full roster with character specs, gear, and talents.

`GET /api/v1/live-tracking/guild/raid-comps`

Relies on combat log data retrieved from the Raider.IO Desktop App.<br><br>You can look up a specific pull by <code>id</code> (obtained from the raid-pulls endpoint), or omit it to get the latest pull. Identify the guild using <b>either</b> <code>guild_id</code> <b>or</b> the <code>region</code>/<code>realm</code>/<code>guild</code> combination.

## 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' | 'latest', required — Raid slug or full name (e.g. "sporefall" or "Sporefall")
- `difficulty` 'mythic' | 'heroic' | 'normal' | 'latest' — Raid difficulty. One of: mythic, heroic, normal. Optional filter.
- `id` 0 — The ID of the pull to look up. You can get this from a raid-pulls call. Setting to 0 will fetch the latest from the guild.
- `guild_id` integer — Raider.IO guild ID. Alternative to the region/realm/guild parameters.
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn' | 'world' — Region to filter by. One of: world, us, eu, kr, tw Required if id == 0.
- `realm` string — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms") Required if id == 0.
- `boss` 'latest' — Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
- `guild` string — Guild name. Not case sensitive. Required if id == 0.

## Response `200`

Successful

- ViewRaidCompsResponse
  - `guild` GuildSummary2, nullable
    - `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
  - `guildPrivacy` RaidCompGuildPrivacy
    - `shareRaidUntil` string, nullable
  - `raid` RaidSummary
    - `id` integer — Raid ID
    - `slug` string — Raid slug
    - `name` string — Raid display name
    - `short_name` string — Abbreviated raid name
    - `icon` string — Icon identifier for the raid
    - `expansion_id` integer — Expansion ID. 11 = Midnight, 10 = TheWarWithin, 9 = Dragonflight, 8 = Shadowlands, 7 = BattleForAzeroth, 6 = Legion
  - `details` RaidCompDetails
    - `kill` RaidCompKill
      - `pulledAt` string
      - `defeatedAt` string, nullable
      - `itemLevelEquippedAvg` number
      - `artifactTraitsAvg` number
    - `raid` RaidSummary
      - `id` integer — Raid ID
      - `slug` string — Raid slug
      - `name` string — Raid display name
      - `short_name` string — Abbreviated raid name
      - `icon` string — Icon identifier for the raid
      - `expansion_id` integer — Expansion ID. 11 = Midnight, 10 = TheWarWithin, 9 = Dragonflight, 8 = Shadowlands, 7 = BattleForAzeroth, 6 = Legion
    - `boss` RaidEncounterSummary
      - `id` integer — Boss encounter ID
      - `slug` string — Boss slug
      - `name` string — Boss display name
      - `ordinal` integer — Boss ordering position within the raid (1-based)
    - `guild` GuildSummary3, nullable
      - `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
    - `roster` RaidCompRosterMember[] — Roster of characters in the pull
      - `character` Character4 — Character details from the combat log
        - `wow_character_id` integer — Blizzard character ID
        - `name` string — Character name
        - `race` Race2 — Character race
          - `id` number
          - `name` string
          - `slug` string
        - `class` Class2 — Character class
          - `id` number
          - `name` string
          - `slug` string
        - `spec` Spec5 — Character specialization
          - `id` number
          - `name` string
          - `slug` string
          - `role` string
          - `is_melee` boolean
        - `gender` string — Character gender
        - `thumbnail` string, nullable — Avatar thumbnail URL
        - `itemLevelEquipped` number — Equipped item level at time of pull
        - `realm` FullRealm2 — Character realm
          - `id` integer
          - `name` string
          - `slug` string
          - `altName` string, nullable
          - `altSlug` string
          - `locale` string
          - `isConnected` boolean
          - `connectedRealmId` integer
          - `realmType` string
          - `wowRealmId` integer
          - `wowConnectedRealmId` integer
        - `stream` Stream2, nullable — Active stream info, if any
          - `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
        - `talentLoadout` TalentLoadout, nullable — Active talent loadout
          - `specId` integer — Spec ID for this loadout
          - `heroSubTreeId` integer, nullable
          - `loadout` TalentLoadoutNode[] — Talent node selections
            - `node` TalentNode
              - …
            - `entryIndex` integer
            - `rank` integer
            - `grantedNode` boolean
          - `loadoutText` string, nullable — Encoded talent loadout string
  - `widgetVersion` integer — Widget version for cache invalidation

---

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