---
title: "Get My Referrals"
method: GET
path: "/referrals/me"
tags: ["referrals"]
---

# Get My Referrals

`GET /referrals/me`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/referrals/me`
- Auth: HTTP bearer

This user's referral link, funnel counts and reward history.

Mints the code on first call rather than at signup, so the accounts that
predate the program need no backfill. Returns `enabled: false` with no code
while the flag is off — minting links people can't be rewarded for would
strand anyone who shared one early.

`enabled: false` is also the answer for a lifetime holder, decided in
referral_summary: there is no recurring invoice for a free month to mean
anything on, so every surface that keys off this flag — the sidebar card,
this section and its nav row, the referral email preference, the promo modal —
hides itself rather than advertising an offer they cannot take.

## Response `200`

Successful Response

- ReferralsMeOut
  - `enabled` boolean, required
  - `code` string, nullable
  - `link` string, nullable
  - `reward_preview` string, nullable
  - `reward` ReferralRewardStateOut: The referrer's OWN reward, right now — what the sidebar badge and the Settings status panel render.
    - `kind` string, nullable
    - `state` string
    - `months_available` integer, nullable
    - `plan_label` string, nullable
    - `ends_at` string, nullable
    - `credit_cents` integer
    - `credit_currency` string, nullable
  - `stats` ReferralStats
    - `signups` integer
    - `awaiting_payment` integer
    - `paid` integer
    - `months_earned` integer
    - `months_used` integer
    - `cap_remaining` integer
    - `cap_months` integer
  - `rewards` ReferralRewardOut[]
    - `status` string, required
    - `mechanism` string, nullable
    - `apply_state` string, nullable
    - `denial_reason` string, nullable
    - `plan_type` string, nullable
    - `created_at` string, date-time, nullable

---

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