---
title: "Get referral earnings and history"
method: GET
path: "/api/referrals"
tags: ["Referrals"]
---

# Get referral earnings and history

`GET /api/referrals`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/referrals`
- Auth: HTTP bearer

Returns your unique referral code, commission rate (20%), earnings breakdown (total, paid, pending), and a history of all referred purchases. Share your referral code with others - when they register with your code (via the `ref` parameter), you earn a commission on all their future domain purchases automatically.

## Response `200`

Referral code, earnings, and history

- object
  - `referral_code` string: Your unique referral code to share
  - `referral_rate` integer: Commission percentage (currently 20%)
  - `total_earned_cents` integer: Total earnings in cents
  - `total_paid_cents` integer: Total paid out in cents
  - `total_pending_cents` integer: Pending payout in cents
  - `referrals` object[]
    - `id` string
    - `domains` string[]
    - `earned_cents` integer
    - `paid_out` boolean
    - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)