---
title: "Api Referral Stats"
method: GET
path: "/api/referral/stats"
---

# Api Referral Stats

`GET /api/referral/stats`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/referral/stats`
- Auth: none declared

Referral program stats.

## Response `200`

Successful Response

- ReferralStatsResponse: `/api/referral/stats` — referrals list (called separately when /code does not include them).
  - `code` string, nullable: The user's referral code, or None if no code has been generated yet.
  - `uses` integer, required: Number of redemptions so far. Zero when code is None.
  - `referrals` ReferralEntry[], required: Recent referrals (≤ 50 entries). FE iterates to render the user's referral list.
    - `redeemed_at` string, nullable: ISO timestamp when the referee redeemed the code. None if never recorded.

---

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