---
title: "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."
method: GET
path: "/api/v1/live-tracking/rwf-event/feed"
tags: ["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.

`GET /api/v1/live-tracking/rwf-event/feed`

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>

## 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
- `types` string — Comma-separated list of event types to include. Valid values: best_percent, new_boss, boss_kill
- `guild_ids` string, required — Comma-separated list of Raider.IO guild IDs to track.
- `border_style` number — Border style variant for event card rendering
- `after` number, 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.
- `test` number — If set, return test/mock event data

## Response `200`

Successful

- ViewRwfEventFeedResponse
  - `events` RwfEvent[]
    - `id` integer — Unique event ID, used as cursor for polling
    - `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
    - `boss` 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)
    - `guild` RwfEventGuild
      - `name` string — Guild name
      - `showPulls` boolean — Whether pull data is publicly visible
      - `showPercents` boolean — Whether percent data is publicly visible
      - `logo` string, nullable — Guild logo URL, or null if default
      - `guildPrivacy` GuildPrivacy2
        - `raidPulls` boolean — Whether raid pull data is shared publicly
        - `raidPercents` boolean — Whether boss health percentages are shared publicly
        - `raidComps` boolean — Whether raid composition data is shared publicly
        - `wereRaidPullsRestricted` boolean — Whether pull data was restricted by guild privacy settings
        - `wereRaidPercentsRestricted` boolean — Whether percent data was restricted by guild privacy settings
        - `wereRaidCompsRestricted` boolean — Whether composition data was restricted by guild privacy settings
        - `shareRaidUntil` string, nullable — ISO 8601 date until which raid data is shared, or null for indefinite
    - `difficulty` string — Raid difficulty (mythic, heroic, normal)
    - `type` string — Event type: best_percent, new_boss, or boss_kill
    - `html` string — Formatted HTML message for the event
    - `bossPortraitImageUrl` string — URL to the boss portrait image
    - `bgImageUrl` string — URL to the event background image
    - `borderImageUrl` string — URL to the event card border image
    - `guildLogoImageUrl` string — URL to the guild logo image

---

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