wow-api-weekly-rewards - SKILL.md Agent Skill

name: wow-api-weekly-rewards description: "Complete reference for WoW Retail Weekly Rewards (Great Vault) API. Covers C_WeeklyRewards — vault activities (M+, raids, PvP, world), reward selection, item preview, canEquip checks, vault UI state, and related events. Use when working with the Great Vault, weekly reward choices, vault activity tracking, or end-of-week item selection."

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

Function	Returns	Description
`C_WeeklyRewards.GetActivities(type)`	`activities`	Activities for type
`C_WeeklyRewards.HasAvailableRewards()`	`hasRewards`	Rewards available?
`C_WeeklyRewards.CanClaimRewards()`	`canClaim`	Can claim now?
`C_WeeklyRewards.HasGeneratedRewards()`	`hasGenerated`	Rewards generated?
`C_WeeklyRewards.GetNumCompletedDungeonRuns(level)`	`numCompleted`	M+ runs at level+

Activity Types

Enum	Value	Description
`Enum.WeeklyRewardChestThresholdType.Activities`	0	World activities
`Enum.WeeklyRewardChestThresholdType.RankedPvP`	1	Rated PvP
`Enum.WeeklyRewardChestThresholdType.MythicPlus`	2	Mythic+ dungeons
`Enum.WeeklyRewardChestThresholdType.Raid`	3	Raid bosses
`Enum.WeeklyRewardChestThresholdType.World`	4	World content

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

Function	Returns	Description
`C_WeeklyRewards.ClaimReward(id)`	—	Claim specific reward
`C_WeeklyRewards.GetItemHyperlink(rewardInfo)`	`hyperlink`	Item link for reward
`C_WeeklyRewards.GetExampleRewardItemHyperlinks(id)`	`hyperlinks`	Example rewards
`C_WeeklyRewards.AreRewardsForCurrentRewardPeriod()`	`isCurrent`	Current week's rewards?

Item Preview & Equip

Function	Returns	Description
`C_WeeklyRewards.CanClaimRewards()`	`canClaim`	Can claim?
`C_WeeklyRewards.HasAvailableRewards()`	`hasAvailable`	Has unclaimed?

Concurrency Info

Function	Returns	Description
`C_WeeklyRewards.GetConquestWeeklyProgress()`	`progress`	Conquest earned

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

Event	Payload	Description
`WEEKLY_REWARDS_UPDATE`	—	Vault data changed
`WEEKLY_REWARDS_SHOW`	—	Vault UI opened
`WEEKLY_REWARDS_HIDE`	—	Vault UI closed
`WEEKLY_REWARDS_ITEM_CHANGED`	—	Reward item changed

Gotchas & Restrictions

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