---
title: "Get Referrals"
method: GET
path: "/referral/all"
tags: ["Referral"]
---

# Get Referrals

`GET /referral/all`

Fetch all referral summaries for the current user.

This endpoint queries the referrals collection for documents where the
referrer_id matches the current user's ID. For each referral, it looks up the
referred user's email using the referred_id, and returns a list of summaries
containing the referred email and the referral status.

Returns:
    List[ReferralSummary]: A list of referral summary objects.

## Response `200`

Successful Response

- ReferralSummary[]
  - `referred_email` string, email, required
  - `status` 'pending' | 'done', required

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)