Reputation API (Retail — Patch 12.0.0)

Comprehensive reference for reputation, faction, major factions, paragon, and neighborhood initiative 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_Reputation — Faction info, standings, watched faction, headers
• •C_MajorFactions — Renown factions (Dragonflight+)
• •Friendship Reputations — Friendship-style rep (Tillers, etc.)
• •Paragon — Paragon reputation (post-max)
• •C_NeighborhoodInitiative — Housing neighborhood rep (12.0.0)

C_Reputation — Core Reputation System

Faction Info

Faction Data Fields

The factionData table contains:

• •factionID — Unique faction ID
• •name — Faction name
• •description — Description text
• •reaction — Standing index (1=Hated to 8=Exalted)
• •currentReactionThreshold — Min rep for current standing
• •nextReactionThreshold — Rep needed for next standing
• •currentStanding — Current rep value
• •atWarWith — At war? (PvP hostile)
• •canToggleAtWar — Can toggle at war?
• •isChild — Is sub-faction?
• •isHeader — Is a header row?
• •isHeaderWithRep — Header that has rep?
• •isCollapsed — Is header collapsed?
• •isWatched — Is watched faction?
• •hasBonusRepGain — Has rep bonus?
• •canSetInactive — Can set inactive?

Watched Faction

Faction List Management

Standing Names

C_MajorFactions — Renown System

Major factions use renown levels instead of traditional reputation standings.

Major Faction Data Fields

• •factionID — Faction ID
• •name — Faction name
• •celebrationSoundKit — Sound on level up
• •renownLevel — Current renown level
• •renownReputationEarned — Rep earned toward next level
• •renownLevelThreshold — Rep needed for next level
• •textureKit — UI texture kit
• •expansionID — Which expansion
• •isUnlocked — Is faction unlocked?
• •unlockDescription — How to unlock

Friendship Reputations

Some factions use friendship instead of traditional reputation.

Friendship Data Fields

• •friendshipFactionID — Faction ID
• •standing — Current standing text (e.g., "Good Friend")
• •maxRep — Max rep for current tier
• •reputation — Current rep value
• •nextThreshold — Next tier threshold
• •text — Standing description
• •texture — Standing icon
• •reaction — Reaction index
• •reversedColor — Reverse progress bar color?

C_NeighborhoodInitiative — Housing Neighborhood (12.0.0)

New in 12.0.0 for the player housing system.

Common Patterns

List All Factions with Standing

local numFactions = C_Reputation.GetNumFactions()
for i = 1, numFactions do
    local data = C_Reputation.GetFactionDataByIndex(i)
    if data and not data.isHeader then
        local standingNames = {"Hated","Hostile","Unfriendly","Neutral","Friendly","Honored","Revered","Exalted"}
        local standing = standingNames[data.reaction] or "Unknown"
        print(data.name, standing, data.currentStanding)
    end
end

Check Renown Level

local function GetRenownProgress(factionID)
    if C_Reputation.IsMajorFaction(factionID) then
        local data = C_MajorFactions.GetMajorFactionData(factionID)
        if data then
            print(data.name, "Renown:", data.renownLevel)
            print("Progress:", data.renownReputationEarned, "/", data.renownLevelThreshold)
            return data.renownLevel
        end
    end
    return nil
end

Check Paragon Reward

local function CheckParagonReward(factionID)
    if C_Reputation.IsFactionParagon(factionID) then
        local currentValue, threshold, questID, hasReward = 
            C_Reputation.GetFactionParagonInfo(factionID)
        if hasReward then
            print("Paragon reward available for faction", factionID)
        end
        return hasReward
    end
    return false
end

Key Events

Gotchas & Restrictions

1. •Headers in faction list — C_Reputation.GetFactionDataByIndex() returns headers. Check isHeader to skip.
2. •Major factions vs traditional — Check C_Reputation.IsMajorFaction() to determine which API to use.
3. •Paragon is post-exalted — GetFactionParagonInfo() only works for factions at Exalted (or max renown for major factions).
4. •Friendship rep display — Friendship factions show custom standing names. Use GetFriendshipReputation() for proper display text.
5. •Account-wide rep — Some 12.0.0 reps are account-wide. Check IsAccountWideReputation().
6. •Collapsed headers — Collapsed headers hide child factions from the indexed list. Expand before iterating.
7. •Faction IDs are stable — Unlike indices, factionIDs are stable and can be persisted in SavedVariables.
8. •Neighborhood initiative — New 12.0.0 system; APIs may evolve.