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

Filter by status (active / suspended), region, or audience. Multiselect filtering by specific conversions and audience IDs is also supported.

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fuul.xyz/core-concepts/affiliate-management-dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.