Sign in

v4

OpenAPI 3.0.02026-07-3137328230.2 KB
Live Tracking - Raiding

Retrieve a Race to World First event feed (kills, best percents, new pulls) for tracked guilds. Supports real-time polling via the "after" cursor parameter.

Relies on combat log data retrieved from the Raider.IO Desktop App.<br><br><b>Polling workflow:</b><ol><li>Call <code>rwf-event/last</code> to get the starting cursor ID</li><li>Call this endpoint with that ID as <code>after</code> and your <code>guild_ids</code></li><li>On each poll, use the highest <code>id</code> from the returned events as the new <code>after</code> value</li><li>Poll every 10–30 seconds for near real-time updates</li></ol>

get/api/v1/live-tracking/rwf-event/feed

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

typesstring

Comma-separated list of event types to include. Valid values: best_percent, new_boss, boss_kill

Comma-separated list of event types to include. Valid values: best_percent, new_boss, boss_kill

guild_idsstring required

Comma-separated list of Raider.IO guild IDs to track.

Comma-separated list of Raider.IO guild IDs to track.

border_stylenumber

Border style variant for event card rendering

Border style variant for event card rendering

afternumber required

Cursor: only return events with an ID greater than this value. Use 0 to fetch all, or the last seen event ID for polling.

Cursor: only return events with an ID greater than this value. Use 0 to fetch all, or the last seen event ID for polling.

testnumber

If set, return test/mock event data

If set, return test/mock event data

Response

Successful

Example response

{
  "events": [
    {
      "id": 54321,
      "raid": {
        "id": 100,
        "slug": "nerubar-palace",
        "name": "Nerub-ar Palace",
        "short_name": "NP"
      },
      "boss": {
        "slug": "the-silken-court",
        "name": "The Silken Court"
      },
      "guild": {
        "guildPrivacy": {
          "raidPulls": true,
          "raidPercents": true,
          "raidComps": true
        }
      }
    }
  ]
}