Weekly Rewards API (Retail — Patch 12.0.0)

Comprehensive reference for the Great Vault / weekly rewards system.

Source: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only.

Scope

• C_WeeklyRewards — Great Vault UI, activities, rewards, item selection

C_WeeklyRewards — Great Vault System

Activity Tracking

Activity Types

Activity Data Fields

Each activity entry contains:

• type — Activity type enum
• index — Slot index (1, 2, 3)
• threshold — Completions needed
• progress — Current completions
• id — Activity ID
• level — Key level / difficulty / rating tier
• rewards — Available rewards table
• rewardOptions — Reward item options

Reward Selection

Item Preview & Equip

Concurrency Info

Common Patterns

Display Great Vault Status

local function ShowVaultStatus()
    local activityTypes = {
        {type = Enum.WeeklyRewardChestThresholdType.MythicPlus, name = "Mythic+"},
        {type = Enum.WeeklyRewardChestThresholdType.Raid, name = "Raid"},
        {type = Enum.WeeklyRewardChestThresholdType.RankedPvP, name = "PvP"},
        {type = Enum.WeeklyRewardChestThresholdType.World, name = "World"},
    }
    
    for _, actType in ipairs(activityTypes) do
        local activities = C_WeeklyRewards.GetActivities(actType.type)
        if activities then
            print(actType.name .. ":")
            for _, activity in ipairs(activities) do
                local status = activity.progress >= activity.threshold and "COMPLETE" or 
                    (activity.progress .. "/" .. activity.threshold)
                local levelInfo = activity.level > 0 and (" (Level " .. activity.level .. ")") or ""
                print("  Slot " .. activity.index .. ": " .. status .. levelInfo)
            end
        end
    end
end

Check for Available Rewards

local f = CreateFrame("Frame")
f:RegisterEvent("WEEKLY_REWARDS_UPDATE")
f:SetScript("OnEvent", function()
    if C_WeeklyRewards.HasAvailableRewards() then
        print("You have Great Vault rewards to claim!")
    end
end)

Preview Vault Rewards

local function PreviewVaultRewards()
    local allActivities = {
        C_WeeklyRewards.GetActivities(Enum.WeeklyRewardChestThresholdType.MythicPlus),
        C_WeeklyRewards.GetActivities(Enum.WeeklyRewardChestThresholdType.Raid),
        C_WeeklyRewards.GetActivities(Enum.WeeklyRewardChestThresholdType.RankedPvP),
    }
    
    for _, activities in ipairs(allActivities) do
        if activities then
            for _, activity in ipairs(activities) do
                if activity.progress >= activity.threshold then
                    local links = C_WeeklyRewards.GetExampleRewardItemHyperlinks(activity.id)
                    if links then
                        for _, link in ipairs(links) do
                            print("  Possible:", link)
                        end
                    end
                end
            end
        end
    end
end

Key Events

Gotchas & Restrictions

1. Weekly reset timing — Rewards are generated at weekly reset; APIs return no data before Tuesday/Wednesday reset.
2. Claim requires hardware — ClaimReward() requires user interaction.
3. Activity types vary by season — Not all activity types are active every season.
4. Three slots per type — Each type has 3 reward slots with increasing thresholds.
5. Level field meaning changes — For M+ it's key level, for raids it's difficulty, for PvP it's rating bracket.
6. Example rewards are estimates — GetExampleRewardItemHyperlinks() shows possible rewards, not guaranteed ones.
7. Rewards expire — Unclaimed vault rewards from a previous week may be forfeited.
8. HasAvailableRewards() vs HasGeneratedRewards() — Generated means the vault has rolled items; Available means the player can claim them now.