Sign in

v5

latestOpenAPI 3.0.02026-08-0437328230.2 KB
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.

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

Query parameters

access_keystring

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

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

Raid slug or full name (e.g. "sporefall" or "Sporefall")

boss'latest' required

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

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

Raid difficulty. One of: mythic, heroic, normal

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

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

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

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.

Guild name. Not case sensitive.

periodstring

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

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

min_datestring

Skip pulls before this date (ISO 8601)

Skip pulls before this date (ISO 8601)

max_datestring

Skip pulls after this date (ISO 8601)

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
      }
    }
  ]
}