---
title: "Get My Referral"
method: GET
path: "/api/v1/referrals/me"
tags: ["referrals"]
---

# Get My Referral

`GET /api/v1/referrals/me`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/referrals/me`
- Auth: none declared

Return the caller's referral code and standing, minting a code on first call.

Args:
    user: Authenticated session user.
    db: Database session.

Returns:
    The caller's referral summary.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ReferralSummaryResponse: The inviter's own standing. Reward amounts are included because the user is being asked to share a link — they need to know what they and their invitee get. This is not the same as exposing them publicly: the route requires a session.
  - `code` string, required
  - `max_grants` integer, required
  - `used_grants` integer, required
  - `remaining_grants` integer, required
  - `referee_reward_memories` integer, required
  - `referrer_reward_memories` integer, required
  - `earned_memories` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)