Live Tracking - Raiding

Retrieve detailed pull history for a specific boss including wipe/kill status, health percentages, and duration. Supports filtering by lockout period and date range.

Changed on

Relies on combat log data retrieved from the Raider.IO Desktop App.<br><br>Health percentages and pull details may be hidden if the guild has restricted data via privacy settings — check the <code>guildPrivacy</code> and <code>error</code> fields in the response.

get/api/v1/live-tracking/guild/boss-pulls

Request

Query parameters

access_keystring

The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

raid'the-unbinding-of-kithix' | '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-unbinding-of-kithix" or "The Unbinding of Kith'ix")

boss'latest' required

Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.

difficulty'mythic' | 'heroic' | 'normal' | 'latest' required

Raid difficulty. One of: mythic, heroic, normal

region'us' | 'eu' | 'tw' | 'kr' | 'cn' required

Region of the guild. One of: us, eu, kr, tw

realmstring required

Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")

guildstring required

Guild name. Not case sensitive.

periodstring

Lockout period. One of: "current", "until_kill", "all", or an integer period ID.

min_datestring

Skip pulls before this date (ISO 8601)

max_datestring

Skip pulls after this date (ISO 8601)

Response

Successful

countinteger

Total number of pulls on this boss

widgetVersioninteger

Widget version for cache invalidation

Example response

{
  "guild": {
    "id": 955,
    "name": "Ludicrous Speed",
    "faction": "horde",
    "realm": {
      "id": 114,
      "connectedRealmId": 114,
      "wowRealmId": 57,
      "wowConnectedRealmId": 11,
      "name": "Skullcrusher",
      "slug": "skullcrusher",
      "altSlug": "skullcrusher",
      "locale": "en_US",
      "realmType": "pve"
    },
    "region": {
      "name": "United States & Oceania",
      "short_name": "US",
      "slug": "us"
    },
    "path": "/guilds/us/skullcrusher/Ludicrous%20Speed",
    "logo": "https://cdn.raider.io/images/site/horde_icon4.png",
    "color": "#ff6600"
  },
  "raid": {
    "id": 100,
    "slug": "nerubar-palace",
    "name": "Nerub-ar Palace",
    "short_name": "NP"
  },
  "guildPrivacy": {
    "raidPulls": true,
    "raidPercents": true,
    "raidComps": true
  },
  "boss": {
    "slug": "the-silken-court",
    "name": "The Silken Court"
  },
  "pulls": [
    {
      "details": {
        "id": 123456,
        "status": "wipe",
        "num_members": 20,
        "num_deaths": 5,
        "duration_ms": 245000,
        "pull_started_at": "2026-01-15T20:30:00.000Z",
        "pull_ended_at": "2026-01-15T20:34:05.000Z",
        "encounter_health": {
          "overall_percent": 45.2,
          "boss_percent": 45.2,
          "phase": 2.1,
          "phase_label": "P2.1",
          "progress_display": "P2 45.2%"
        },
        "period": 1000
      }
    }
  ]
}

Changes