> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/core-concepts/affiliates/affiliate-management-dashboard.md).

# Affiliate Management Dashboard

The affiliate management dashboard gives program admins full visibility and control over their affiliate base — from reviewing incoming applications to managing tiers, badges, and individual performance.

Access it at **Affiliates → Dashboard** in the Fuul app.

## Affiliate list

View all active affiliates in your program with their performance metrics:

| Metric              | Description                                       |
| ------------------- | ------------------------------------------------- |
| **Volume**          | Total action volume attributed to this affiliate  |
| **Revenue**         | Fees or revenue generated by their referred users |
| **End users**       | Total unique users brought in                     |
| **Earnings**        | Total payouts per currency                        |
| **Tier / Audience** | Which reward tier they currently qualify for      |

### Tier details

Each affiliate's profile shows:

* **Active tier** — The effective tier after accounting for any protection period
* **Current tier** — The tier based on current metrics, before protection is applied
* **Tier protection** — Days remaining in the protection period (1–365)
* **Protection** — A badge showing where the protection stands, with the exact expiry date in the tooltip

| Protection badge      | Meaning                                                           |
| --------------------- | ----------------------------------------------------------------- |
| **Protected** (green) | Protection active, more than 30 days left                         |
| **Expiring** (yellow) | Protection active, 30 days or less left                           |
| **Expired** (red)     | Protection lapsed within the last 7 days                          |
| —                     | No protection pinning the tier, or it lapsed more than 7 days ago |

The badge only appears when the protection is actually holding the affiliate's tier. A protection still awaiting approval, or set to a tier below the one the affiliate already earns, shows no badge. When a protection expires the affiliate moves to the tier their audiences and metrics give them, which is not necessarily the default tier.

Filter by status (active / suspended), region, audience, or protection (multi-select). Multiselect filtering by specific conversions and audience IDs is also supported. The CSV export honors the protection filter.

## Applications

When your program requires approval before affiliates can join, review and process incoming applications here.

| Action      | Description                                       |
| ----------- | ------------------------------------------------- |
| **Approve** | Add the affiliate to a static audience (required) |
| **Reject**  | Record a rejection reason                         |
| **Hold**    | Keep for later review                             |

{% hint style="info" %}
Click any affiliate to view their referral tree, audience memberships, badges, status, and activity history.
{% endhint %}

## Master Affiliates

A master affiliate manages a pool of sub-affiliates and earns a spread on each conversion they generate. Admins designate any existing affiliate as a master affiliate — a marketing agency is a common example.

Master affiliate list and detail responses include aggregated metrics:

| Field                  | Description                                                                     |
| ---------------------- | ------------------------------------------------------------------------------- |
| `sub_affiliates_count` | Number of sub-affiliates bound to this master affiliate                         |
| `referred_volume_usd`  | Combined L1 volume of the master's sub-affiliates (not the master's own volume) |

**Admin API endpoints** (require Admin role):

| Endpoint                                                            | Description                                                                             |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `GET /api/v1/projects/:projectId/agencies`                          | List all master affiliates with aggregated metrics                                      |
| `GET /api/v1/projects/:projectId/agencies/:agencyId`                | Master affiliate detail with per-currency earnings                                      |
| `GET /api/v1/projects/:projectId/agencies/:agencyId/sub-affiliates` | Sub-affiliates with individual volume and earnings. Supports `sort_by=referred_volume`. |

Admins can remove master status from an affiliate — this downgrades it back to a regular sub-affiliate while preserving all historical attribution and payout data.

{% hint style="info" %}
Master affiliate payouts (`agency_payout`) are excluded from leaderboard rankings. Only `affiliate_payout` and `end_user_payout` movements count toward leaderboard position.
{% endhint %}

## Audiences, tiers & badges

The dashboard shows each affiliate's audience memberships and badges. These features are not exclusive to affiliates — they apply to any user in the program.

* **Audiences & Tiers** — segment users and assign different reward rates → [Tiers & Multipliers](/core-concepts/tiers-and-multipliers.md)
* **Badges** — visual recognition for users based on audience membership → [Badges](/incentives-manager/badges.md)

{% hint style="info" %}
Approving an affiliate application automatically adds them to the audience you select during approval. This is the recommended way to onboard affiliates into a specific tier.
{% endhint %}