---
title: "Retrieve a gear summary for a guild roster. Supports two scopes: \"pull\" uses combat log data from raid encounters, \"armory\" uses the latest Blizzard armory snapshot."
method: GET
path: "/api/v1/live-tracking/guild/gear-summary"
tags: ["Live Tracking - General"]
---

# Retrieve a gear summary for a guild roster. Supports two scopes: "pull" uses combat log data from raid encounters, "armory" uses the latest Blizzard armory snapshot.

`GET /api/v1/live-tracking/guild/gear-summary`

The <code>pull</code> scope relies on combat log data retrieved from the Raider.IO Desktop App. The <code>armory</code> scope uses Blizzard armory data and does not require the Desktop App.<br><br>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-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' | 'latest', required — Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")
- `difficulty` 'mythic' | 'heroic' | 'normal' | 'latest' — Raid difficulty. One of: mythic, heroic, normal. Optional filter.
- `scope` 'pull' | 'armory' — Data source scope. "pull" uses combat log data from raid pulls. "armory" uses the latest armory snapshot.
- `advanced_search` boolean — Enable advanced search mode with additional filtering options
- `before_date` string — For "pull" scope only: only consider pulls before this date (ISO 8601)
- `boss` string — For "pull" scope only: request data from a specific boss slug
- `first_kill` boolean — For "pull" scope only: only show data from up to the first kill
- `period` integer — For "pull" scope only: request data from a specific lockout period. 0 = all periods.
- `pull_id` 0 — For "pull" scope only: 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 guild_id not provided.
- `realm` string — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms") Required if guild_id not provided.
- `guild` string — Guild name. Not case sensitive. Required if guild_id not provided.

## Response `200`

Successful

- ViewGearSummaryResponse
  - `guild` GuildSummary1, 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
  - `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
  - `top20ItemLevel` number, nullable — Average item level of top 20 geared players
  - `roster` GearSummaryRosterMember[] — Roster members with gear data
    - `character` Character3 — Character details with gear
      - `wow_character_id` integer — Blizzard character ID
      - `name` string — Character name
      - `race` Race1 — Character race
        - `id` number
        - `name` string
        - `slug` string
      - `class` Class1 — Character class
        - `id` number
        - `name` string
        - `slug` string
      - `spec` Spec4 — 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
      - `realm` FullRealm1 — 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
      - `items` ItemsContainer2, nullable — 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
  - `code` integer — Error code if access restricted
  - `error` string — Error message if access restricted
  - `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/revisions/d89777d7faee/schema)