---
title: "Retrieve pull counts and details for each boss encounter. Returns all encounters with pull history for the specified guild, raid, and difficulty."
method: GET
path: "/api/v1/live-tracking/guild/raid-pulls"
tags: ["Live Tracking - Raiding"]
---

# Retrieve pull counts and details for each boss encounter. Returns all encounters with pull history for the specified guild, raid, and difficulty.

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

Relies on combat log data retrieved from the Raider.IO Desktop App. Guilds that do not use the Desktop App will return empty results.<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 — do not mix both.

## 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', required — Raid difficulty. One of: mythic, heroic, normal
- `period` integer — The integer period to show pulls from. If not supplied will show across all periods
- `start_range` string, date — The start range of attempts (ISO 8601)
- `end_range` string, date — The end range of attempts (ISO 8601)
- `region` 'us' | 'eu' | 'tw' | 'kr' | 'cn' | 'world' — Region to filter by. One of: world, us, eu, kr, tw
- `realm` string — Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
- `guild` string — Guild name. Not case sensitive.
- `guild_id` integer — Raider.IO guild ID. Alternative to the region/realm/guild parameters.

## Response `200`

Successful

- ViewRaidPullsResponse
  - `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
  - `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
  - `pulls` RaidPullEntry[]
    - `count` integer — Number of pulls on this encounter
    - `encounter` 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)
    - `details` RaidPullDetail[]
      - `id` integer — Unique pull ID
      - `status` string — Pull outcome status (e.g. "wipe", "kill", "reset")
      - `is_success` boolean — Whether the boss was killed on this pull
      - `is_reset` boolean — Whether the encounter was soft-reset
      - `num_members` integer — Number of raid members present for the pull
      - `num_deaths` integer — Total player deaths during the pull
      - `duration_ms` integer — Pull duration in milliseconds
      - `pull_started_at` string — ISO 8601 timestamp when the pull started
      - `pull_ended_at` string — ISO 8601 timestamp when the pull ended
      - `encounter_health` EncounterHealth — Boss health at the end of the pull
        - `overall_percent` number, nullable — Combined health % of all NPCs in the encounter (0-100). Null if the boss has no health tracking.
        - `boss_percent` number, nullable — Health % of the primary boss NPC (0-100). Null if the boss has no health tracking.
        - `phase` number, nullable — Current encounter phase number, or null if not phased
        - `phase_label` string, nullable — Current encounter phase label, or null if not phased
        - `progress_display` string — Human-readable progress string (e.g. "45.2%", "P2 32.1%")
        - `npcs` Model3[] — Per-NPC health breakdown
      - `period` integer — Lockout period ID this pull occurred in
      - `raidcomp_url` string — URL to view the raid composition for this pull

---

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