---
title: "Retrieve item level history for up to 10 guilds in one comparison request."
method: GET
path: "/api/v1/live-tracking/guild/ilvl-history/batch"
tags: ["Live Tracking - Raiding"]
---

# Retrieve item level history for up to 10 guilds in one comparison request.

`GET /api/v1/live-tracking/guild/ilvl-history/batch`

## 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-venomous-abyss' | 'the-tidebound-grotto' | '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. "the-venomous-abyss" or "The Venomous Abyss")
- `top_n` integer — How many of the highest geared eligible roster characters to average
- `difficulty` 'mythic' | 'heroic' | 'normal' | 'latest' — Raid difficulty. One of: mythic, heroic, normal. 'latest' resolves per guild to their highest difficulty with kills.
- `include_pulls` boolean — Also return the logged per-pull raid group item level averages
- `pulls_difficulty` string — Comma separated difficulties the pull overlay covers, e.g. `heroic,mythic`. Defaults to `all`, so split runs on a lower difficulty than the tracked progression still show up
- `pulls_scope` 'cohort' | 'all' — Which logged raids the pull overlay covers: 'cohort' keeps only raids one of the tracked top-N characters was in, 'all' keeps every raid any guild member was in
- `bucket` '15min' | 'hour' | '6hour' | 'day' — Sampling interval of the item level series; auto-promoted on long windows
- `scope` 'all' | 'mains' — Which roster characters to sample: every eligible character, or mains only
- `min_date` string, date-time — Clamp the window start to this date (ISO 8601)
- `max_date` string, date-time — Clamp the window end to this date (ISO 8601)
- `guilds` string, required — Up to 10 region/realm/guild paths separated by |

## Response `200`

Successful

- ViewGuildIlvlHistoryBatchResponse
  - `guilds` Model8[], required
  - `errors` Model9[], required
    - `guild` string, required
    - `error` string, required

---

[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/revisions/d89777d7faee/schema)