---
title: "Get referral lineage"
method: GET
path: "/admin/invite/referral-lineage/{wallet}"
tags: ["Admin"]
---

# Get referral lineage

`GET /admin/invite/referral-lineage/{wallet}`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/invite/referral-lineage/{wallet}`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/invite/referral-lineage/:wallet/get.ts> (a function with typed inputs; its response is checked against the schema)

Walk a wallet's invite-code redemption chain up to its root (the wallet that redeemed no one else's code) and report the hop count. depth=0 means the wallet itself is a root; depth=1/2/... means it is that many levels below the root (L1, L2, ...).

## Path parameters

- `wallet` string, required

## Response `200`

A successful response.

- ApiGetReferralLineageResponse
  - `root` string: The wallet at the top of this chain — the one that redeemed no one else's invite code. Equals `wallet` when it is itself a root.
  - `depth` integer: Hops from root to `wallet`. 0 = wallet is the root; 1 = wallet redeemed root's own code (L1); 2 = wallet redeemed an L1 wallet's code (L2); and so on.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/invite/referral-lineage/:wallet/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)