Wow API Group Lfg

Group & LFG API (Retail — Patch 12.0.0)

Comprehensive reference for party/raid management, dungeon finder, premade groups, and related APIs.

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_PartyInfo — Party management, invites, conversion
• C_LFGInfo — Dungeon Finder queue system
• C_LFGList — Premade Groups (Group Finder)
• C_SocialQueue — Social queue tracking
• C_LobbyMatchmakerInfo — Lobby matchmaker
• Raid Markers — World and target markers
• Group utility — Ready check, countdown, roles

C_PartyInfo — Party Management

Core Functions

Group Query Functions (Global)

Role Functions

Ready Check Functions

C_LFGInfo — Dungeon Finder

LFG Global Functions

C_LFGList — Premade Groups (Group Finder)

Search & Browse

Create & Manage Listing

Applications

Raid Markers

Marker Index Values

Common Patterns

Check Group Type and Size

local function GetGroupInfo()
    if IsInRaid() then
        return "raid", GetNumGroupMembers()
    elseif IsInGroup() then
        return "party", GetNumGroupMembers()
    else
        return "solo", 1
    end
end

Iterate Group Members

local function ForEachGroupMember(callback)
    local prefix = IsInRaid() and "raid" or "party"
    local numMembers = GetNumGroupMembers()
    
    if IsInRaid() then
        for i = 1, numMembers do
            callback(prefix .. i)
        end
    else
        callback("player")
        for i = 1, numMembers - 1 do
            callback(prefix .. i)
        end
    end
end

ForEachGroupMember(function(unit)
    print(UnitName(unit), UnitGroupRolesAssigned(unit))
end)

Search Premade Groups

-- Search for M+ groups
local CATEGORY_DUNGEON = 2
C_LFGList.Search(CATEGORY_DUNGEON, "")

local frame = CreateFrame("Frame")
frame:RegisterEvent("LFG_LIST_SEARCH_RESULTS_RECEIVED")
frame:SetScript("OnEvent", function()
    local totalResults, results = C_LFGList.GetSearchResults()
    for _, resultID in ipairs(results) do
        local info = C_LFGList.GetSearchResultInfo(resultID)
        if info then
            print(info.name, info.comment, info.numMembers)
        end
    end
end)

Key Events

Gotchas & Restrictions

1. InviteUnit requires hardware event — Must be called from a user click/key handler.
2. Party vs raid iteration — Use different unit tokens: "party1"-"party4" vs "raid1"-"raid40". Player is NOT in party tokens.
3. Category matters — IsInGroup() defaults to LE_PARTY_CATEGORY_HOME. Use LE_PARTY_CATEGORY_INSTANCE for LFG groups.
4. GROUP_ROSTER_UPDATE fires often — Debounce processing. Fires for role changes, joins, leaves, subgroup changes.
5. LFG search is async — C_LFGList.Search() is async. Wait for LFG_LIST_SEARCH_RESULTS_RECEIVED.
6. SendAddonMessage in instances — Blocked in 12.0.0. Group addons cannot communicate via addon messages in instances.
7. Cross-faction groups — Check C_PartyInfo.IsCrossFactionParty() to handle cross-faction UI properly.
8. Raid markers require assist — SetRaidTarget() requires leader or assistant in raids.

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