GET /api/v1/users/me/referral/children

Returns the list of users referred by the currently authenticated user, including their activity summary.

Authentication

Required. Bearer token must be included in the Authorization header.

Request

No request body or query parameters required.

Example

curl -X GET https://intotes.com/api/v1/users/me/referral/children \
  -H "Authorization: Bearer <token>"

Response

200 OK

[
  {
    "id": 101,
    "username": "trader_jane",
    "image": "https://cdn.intotes.com/avatars/101.jpg",
    "level": 1,
    "joined_date": "2025-09-01T12:00:00Z",
    "total_bets": 48,
    "total_volume": 1250000
  },
  {
    "id": 205,
    "username": "crypto_mike",
    "image": "https://cdn.intotes.com/avatars/205.jpg",
    "level": 1,
    "joined_date": "2025-09-15T08:30:00Z",
    "total_bets": 22,
    "total_volume": 540000
  },
  {
    "id": 310,
    "username": "betking99",
    "image": null,
    "level": 2,
    "joined_date": "2025-10-02T16:45:00Z",
    "total_bets": 11,
    "total_volume": 210000
  }
]

Response Fields

Field	Type	Description
id	int64	Referred user's ID
username	string	Referred user's display name or nickname
image	string	Avatar URL of the referred user (or null)
level	int	Referral level (1 = direct, 2 = second-degree, 3 = third-degree)
joined_date	string	ISO 8601 timestamp of when the referred user joined
total_bets	int	Total number of bets placed by the referred user
total_volume	int64	Total trading volume of the referred user in kopecks

Errors

Status	Code	Description
401	unauthorized	Missing or invalid authentication token