---
title: "Retrieve information about a guild boss kill."
method: GET
path: "/api/v1/guilds/boss-kill"
tags: ["guild"]
---

# Retrieve information about a guild boss kill.

`GET /api/v1/guilds/boss-kill`

## 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.
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn', required — Name of region to look up guild in. Can be one of: us, eu, kr, tw
- `realm` string, required — Name of realm that guild is on. This can be in slug or title format, e.g. "Altar of Storms" or "altar-of-storms"
- `guild` string, required — Name of the guild to look up. This is not case sensitive.
- `raid` 'the-venomous-abyss' | 'the-tidebound-grotto' | '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 slug to look up
- `boss` string, required — Boss slug to look up
- `difficulty` 'mythic' | 'heroic' | 'normal', required — Raid difficulty to look up

## Response `200`

Successful

- ViewGuildBossKillResponse
  - `kill` BossKill
    - `pulledAt` string, nullable — When the boss was pulled
    - `defeatedAt` string, nullable — When the boss was defeated
    - `durationMs` integer, nullable — Kill duration in milliseconds
    - `isSuccess` boolean — Whether the kill was successful
    - `itemLevelEquippedAvg` number — Average equipped item level of the raid
    - `itemLevelEquippedMax` number — Maximum equipped item level in the raid
    - `itemLevelEquippedMin` number — Minimum equipped item level in the raid
  - `roster` BossKillRosterMember[] — Roster of characters in the kill
    - `character` Character — Character details
      - `id` integer — Character ID
      - `name` string — Character name
      - `class` Class
        - `id` number
        - `name` string
        - `slug` string
      - `spec` Spec1
        - `id` number
        - `name` string
        - `slug` string
        - `role` string
        - `class_id` integer
        - `is_melee` boolean
        - `ordinal` integer
        - `patch` string
      - `race` Race
        - `id` number
        - `name` string
        - `slug` string
        - `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
      - `faction` string
      - `level` integer
      - `gender` string
      - `thumbnail` string, nullable
      - `itemLevelEquipped` number — Equipped item level
      - `artifactTraits` integer
      - `items` ItemsContainer — Equipped gear details
        - `created_at` string, nullable
        - `updated_at` string, nullable
        - `source` string
        - `item_level_equipped` integer — Equipped item level
        - `item_level_total` integer
        - `artifact_traits` integer
        - `corruption` Corruption — Corruption stats
          - `added` number
          - `resisted` number
          - `total` number
          - `cloakRank` integer
          - `spells` string[]
        - `items` Items — Map of slot name to equipped item
      - `talentLoadout` TalentLoadout, nullable — Active talent loadout
        - `specId` integer — Spec ID for this loadout
        - `heroSubTreeId` integer, nullable
        - `loadout` TalentLoadoutNode[] — Talent node selections
          - `node` TalentNode
            - `id` integer
            - `treeId` integer
            - `subTreeId` integer
            - `type` integer
            - `entries` TalentEntry[]
              - …
            - `important` boolean
            - `posX` integer
            - `posY` integer
            - `row` integer
            - `col` integer
          - `entryIndex` integer
          - `rank` integer
          - `grantedNode` boolean
        - `loadoutText` string, nullable — Encoded talent loadout string
      - `interestingAuras` Spell[] — Notable active auras
        - `id` integer
        - `name` string
        - `icon` string
        - `school` integer
        - `rank` string, nullable
        - `hasCooldown` boolean
      - `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
    - `vantus` boolean — Whether Vantus Rune was active

---

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