---
title: "Get Referral Stats"
method: GET
path: "/api/v1/referral/stats"
tags: ["referral"]
---

# Get Referral Stats

`GET /api/v1/referral/stats`

获取用户推荐统计.

## Response `200`

Successful Response

- ReferralStatsResponse — 用户推荐统计响应.
  - `referral_code` string, required
  - `total_referred` integer, required
  - `consumed_referred` integer, required
  - `pending_reward_amount` number, required
  - `applied_reward_amount` number, required
  - `reward_claim_threshold` number, required
  - `referral_records` object[], required
  - `has_referrer` boolean, required
  - `has_paid_orders` boolean, required

---

[API](https://skmtc.dev/qcode/apis/qcode-web.md) · [All operations](https://skmtc.dev/qcode/apis/qcode-web/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qcode/qcode-web/revisions/2f2f5f49ffc7/schema)