Wow Api Reputation

---
name: wow-api-reputation
description: "Complete reference for WoW Retail Reputation, Faction, Major Factions, Paragon, and Neighborhood Initiative APIs. Covers C_Reputation (faction info, standings, watched faction, headers, friendship reps, paragon), C_MajorFactions (Dragonflight+ renown factions, renown levels, rewards), C_NeighborhoodInitiative (12.0.0 housing neighborhood reputation), faction expansion data, and reputation-related events. Use when working with reputation tracking, faction standings, renown systems, paragon rewards, friendship reputations, or neighborhood initiatives."
---

# 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

| Function | Returns | Description |
|----------|---------|-------------|
| `C_Reputation.GetNumFactions()` | `numFactions` | Number of factions in list |
| `C_Reputation.GetFactionDataByIndex(index)` | `factionData` | Faction data at index |
| `C_Reputation.GetFactionDataByID(factionID)` | `factionData` | Faction data by ID |
| `C_Reputation.IsFactionActive(factionID)` | `isActive` | Is faction active? |
| `C_Reputation.IsMajorFaction(factionID)` | `isMajor` | Is major faction? |
| `C_Reputation.IsAccountWideReputation(factionID)` | `isAccountWide` | Account-wide rep? |
| `C_Reputation.GetFactionParagonInfo(factionID)` | `currentValue, threshold, questID, hasRewardPending, tooLowLevelForParagon` | Paragon info |
| `C_Reputation.IsFactionParagon(factionID)` | `isParagon` | Has paragon? |
| `C_Reputation.RequestFactionParagonPreloadRewardData(factionID)` | — | Preload paragon data |

### 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

| Function | Returns | Description |
|----------|---------|-------------|
| `C_Reputation.GetWatchedFactionData()` | `factionData` | Watched faction info |
| `C_Reputation.SetWatchedFactionByIndex(index)` | — | Set watched by index |

### Faction List Management

| Function | Returns | Description |
|----------|---------|-------------|
| `C_Reputation.ExpandFactionHeader(index)` | — | Expand header |
| `C_Reputation.CollapseFactionHeader(index)` | — | Collapse header |
| `C_Reputation.SetFactionActive(index)` | — | Set faction active |
| `C_Reputation.SetFactionInactive(index)` | — | Set faction inactive |
| `C_Reputation.ToggleAtWar(index)` | — | Toggle at war |

### Standing Names

| Index | Standing |
|-------|----------|
| 1 | Hated |
| 2 | Hostile |
| 3 | Unfriendly |
| 4 | Neutral |
| 5 | Friendly |
| 6 | Honored |
| 7 | Revered |
| 8 | Exalted |

---

## C_MajorFactions — Renown System

Major factions use renown levels instead of traditional reputation standings.

| Function | Returns | Description |
|----------|---------|-------------|
| `C_MajorFactions.GetMajorFactionData(factionID)` | `majorFactionData` | Major faction info |
| `C_MajorFactions.GetMajorFactionIDs(expansionID)` | `factionIDs` | Major factions for expansion |
| `C_MajorFactions.GetCurrentRenownLevel(factionID)` | `renownLevel` | Current renown level |
| `C_MajorFactions.GetRenownLevels(factionID)` | `levels` | All renown levels |
| `C_MajorFactions.GetRenownRewardsForLevel(factionID, renownLevel)` | `rewards` | Rewards at level |
| `C_MajorFactions.HasMaximumRenown(factionID)` | `hasMax` | At max renown? |
| `C_MajorFactions.IsWeeklyRenownCapped(factionID)` | `isCapped` | Weekly cap reached? |
| `C_MajorFactions.GetMajorFactionRenownInfo(factionID)` | `renownInfo` | Renown progress info |

### 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.

| Function | Returns | Description |
|----------|---------|-------------|
| `C_Reputation.GetFriendshipReputation(factionID)` | `friendshipData` | Friendship rep info |
| `C_Reputation.IsFactionFriendship(factionID)` | `isFriendship` | Uses friendship? |

### 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.

| Function | Returns | Description |
|----------|---------|-------------|
| `C_NeighborhoodInitiative.GetCurrentInitiative()` | `initiativeInfo` | Current initiative |
| `C_NeighborhoodInitiative.GetInitiativeProgress()` | `progress` | Progress info |
| `C_NeighborhoodInitiative.GetInitiativeRewards()` | `rewards` | Initiative rewards |

---

## Common Patterns

### List All Factions with Standing

```lua
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

```lua
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

```lua
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

| Event | Payload | Description |
|-------|---------|-------------|
| `UPDATE_FACTION` | — | Reputation changed |
| `QUEST_LOG_UPDATE` | — | Quest/rep update (shared) |
| `MAJOR_FACTION_RENOWN_LEVEL_CHANGED` | factionID, newRenownLevel, oldRenownLevel | Renown level up |
| `MAJOR_FACTION_UNLOCKED` | factionID | Major faction unlocked |
| `UPDATE_EXPANSION_LEVEL` | — | Expansion level changed |

---

## 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.