Sign in

v5

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

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.

get/api/v1/live-tracking/guild/raid-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")

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

Raid difficulty. One of: mythic, heroic, normal

Raid difficulty. One of: mythic, heroic, normal

periodinteger

The integer period to show pulls from. If not supplied will show across all periods

The integer period to show pulls from. If not supplied will show across all periods

start_rangestring date

The start range of attempts (ISO 8601)

The start range of attempts (ISO 8601)

end_rangestring date

The end range of attempts (ISO 8601)

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

Region to filter by. One of: world, us, eu, kr, tw

realmstring

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

Guild name. Not case sensitive.

Guild name. Not case sensitive.

guild_idinteger

Raider.IO guild ID. Alternative to the region/realm/guild parameters.

Raider.IO guild ID. Alternative to the region/realm/guild parameters.

Response

Successful

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"
  },
  "pulls": [
    {
      "encounter": {
        "slug": "the-silken-court",
        "name": "The Silken Court"
      },
      "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
        }
      ]
    }
  ]
}