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 onRelies 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.
Request
- Base URLhttp://raider.io
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.
Raid slug or full name (e.g. "the-unbinding-of-kithix" or "The Unbinding of Kith'ix")
Boss name in slug form (e.g. "the-silken-court"). Use "latest" for the most recent boss being progressed.
Raid difficulty. One of: mythic, heroic, normal
Region of the guild. One of: us, eu, kr, tw
Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")
Guild name. Not case sensitive.
Lockout period. One of: "current", "until_kill", "all", or an integer period ID.
Skip pulls before this date (ISO 8601)
Skip pulls after this date (ISO 8601)
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"
},
"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
- info
added the new enum value
the-unbinding-of-kithixto thequeryrequest parameterraid
- info
- info
added the new enum value
the-tidebound-grottoto thequeryrequest parameterraid
- info