---
title: "List Referral Grants"
method: GET
path: "/api/v1/admin/referrals"
tags: ["admin-referrals"]
---

# List Referral Grants

`GET /api/v1/admin/referrals`

## 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/admin/referrals`
- Auth: none declared

List referral grants, newest first.

Args:
    user: Authenticated system admin.
    referrer_user_id: Restrict to a single inviter.
    include_revoked: Include already-revoked rows (default true).
    limit: Page size.
    offset: Page offset.
    db: Database session.

Returns:
    A page of ledger rows plus the total count.

## Query parameters

- `referrer_user_id` string, nullable
- `include_revoked` boolean
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- AdminReferralListResponse: Paged ledger listing.
  - `items` AdminReferralGrantResponse[], required
    - `id` unknown, required
    - `referrer_user_id` unknown, required
    - `referrer_workspace_id` unknown, required
    - `referred_user_id` unknown, required
    - `referred_workspace_id` unknown, required
    - `referrer_bonus_memories` unknown, required
    - `referred_bonus_memories` unknown, required
    - `granted_at` unknown, required
    - `revoked_at` unknown, required
    - `revoked_reason` unknown, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` 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)