Wow API Quests

Quest API (Retail — Patch 12.0.0)

Comprehensive reference for all quest-related APIs in WoW Retail.

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_QuestLog — Quest log management, tracking, completion, objectives
• C_QuestInfoSystem — Quest type/tag info, quest classification
• C_QuestOffer — Quest accept/decline/complete flows
• C_QuestSession — Party sync quest sessions
• C_QuestTaskInfo — Bonus objectives, world quests
• C_ContentTracking — Content tracking system
• C_CampaignInfo — Campaign (story chapter) tracking
• C_QuestHubUI — Quest hub display
• C_QuestLineUI — Quest line (chain) info
• C_QuestItemUse — Quest item use tracking
• Quest POI — POI data for quest objectives
• Quest Gossip — NPC gossip quest interaction

C_QuestLog — Quest Log

Quest State & Info

Quest Completion & Tracking

Quest Tracking

Quest Objectives

Quest Actions

Quest Rewards (from quest log)

C_QuestInfoSystem

C_QuestOffer — Quest Accept/Decline

C_QuestSession — Party Sync

C_QuestTaskInfo — Bonus Objectives / World Quests

C_CampaignInfo — Campaigns

C_QuestLineUI — Quest Lines

C_ContentTracking

Quest POI Functions

Common Patterns

Iterate Quest Log

local numEntries, numQuests = C_QuestLog.GetNumQuestLogEntries()
for i = 1, numEntries do
    local info = C_QuestLog.GetInfo(i)
    if info and not info.isHeader then
        local questID = info.questID
        local title = info.title
        local isComplete = C_QuestLog.IsComplete(questID)
        print(title, isComplete and "(Complete)" or "")
    end
end

Track/Untrack Quest

local function ToggleQuestWatch(questID)
    if C_QuestLog.IsQuestWatched(questID) then
        C_QuestLog.RemoveQuestWatch(questID)
    else
        C_QuestLog.AddQuestWatch(questID, Enum.QuestWatchType.Automatic)
    end
end

World Quests on Map

local function GetWorldQuestsOnMap(uiMapID)
    local quests = C_TaskQuest.GetQuestsForPlayerByMapID(uiMapID)
    if quests then
        for _, quest in ipairs(quests) do
            local title = C_TaskQuest.GetQuestInfoByQuestID(quest.questId)
            local timeLeft = C_TaskQuest.GetQuestTimeLeftMinutes(quest.questId)
            print(title, timeLeft and (timeLeft .. " min left") or "")
        end
    end
end

Quest Completion Event Handling

local frame = CreateFrame("Frame")
frame:RegisterEvent("QUEST_TURNED_IN")
frame:RegisterEvent("QUEST_ACCEPTED")
frame:RegisterEvent("QUEST_REMOVED")
frame:SetScript("OnEvent", function(self, event, ...)
    if event == "QUEST_TURNED_IN" then
        local questID, xpReward, moneyReward = ...
        print("Completed quest:", C_QuestLog.GetTitleForQuestID(questID))
    elseif event == "QUEST_ACCEPTED" then
        local questID = ...
        print("Accepted quest:", C_QuestLog.GetTitleForQuestID(questID))
    elseif event == "QUEST_REMOVED" then
        local questID, wasReplayQuest = ...
        print("Quest removed:", questID)
    end
end)

Key Events

Gotchas & Restrictions

1. Quest data may not be loaded — Call C_QuestLog.RequestLoadQuestByID(questID) and wait for QUEST_DATA_LOAD_RESULT before accessing quest info for quests not in the log.
2. GetInfo returns headers — Quest log entries include headers (zones). Check info.isHeader to filter.
3. Quest watch limit — There's a maximum number of tracked quests. AddQuestWatch() returns false if at limit.
4. Auto-accept quests — Some quests auto-accept. Check QuestGetAutoAccept() to handle gracefully.
5. World quest vs regular — World quests use C_TaskQuest functions, not C_QuestLog for map display.
6. Quest gossip flow — Quest accept flow: QUEST_GREETING → QUEST_DETAIL → AcceptQuest() → QUEST_ACCEPTED.
7. Campaign quests — Use C_CampaignInfo.IsCampaignQuest() to identify story quests.
8. Objective data — GetQuestObjectives() returns a table with text, type, finished, numFulfilled, numRequired per objective.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.