> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Refer and Earn

> Share your link. You and your friend both receive wallet credits after they become a customer.

Refer and Earn is a two-sided referral program on the **main platform** only. White-label domains and reseller customer workspaces do not see it.

## How it works

1. Open **Settings → Refer and earn** and copy your personal link (`/register?ref=…`).
2. A friend signs up on the main domain with that link. They still receive the normal free signup credits.
3. When that workspace makes its **first paid conversion** — a paid plan invoice or a credit top-up — both of you receive the same wallet credit reward.

Rewards land in the **wallet** (purchased credits). They do not expire at the end of the billing period.

Launch amounts (admin-configurable):

| Side                         | Reward                              |
| ---------------------------- | ----------------------------------- |
| You (referrer)               | 1,250 credits (50 minutes)          |
| Your friend (after they pay) | 1,250 credits (50 minutes)          |
| Cap                          | 10 rewarded referrals per workspace |

## What does not pay out

* Signup alone (no paid plan and no credit purchase)
* Team-member invites
* Self-referrals (same user or same workspace)
* White-label / reseller customer signups
* Referrals after the workspace cap is reached

## In the app

* **Settings → Refer and earn** — share link and history (`Pending` / `Rewarded`)
* A short promo on **Settings → Balance**
* Sidebar credits footer: **Refer and earn**

## API and MCP

* `GET /api/v1/referrals` — share link, amounts, and masked history. Scope `billing:read`.
* MCP tool `get_referrals` — same payload. Scope `billing:read` or `calls:read`.

Reseller and white-label workspaces receive `404`. Internal workspace IDs are never returned.