GET /api/v1/users/{id}

Returns the public profile of a user by their numeric ID. When the request includes a valid authentication token, additional fields may be included in the response.

Authentication

Optional. Providing a Bearer token may return extended profile data.

Request

Path Parameters

Parameter	Type	Required	Description
id	int64	Yes	The user's unique ID

Example

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

Response

200 OK

When viewing your own profile (authenticated as user 42):

{
  "id": 42,
  "name": "Alice",
  "nickname": "alice_bet",
  "profile_hidden": false,
  "email": "alice@example.com",
  "referral_code": "XYZ789",
  "language": "en",
  "theme": "dark",
  "level": 0,
  "balance": 125050,
  "bonus_balance": 0,
  "total_balance": 125050,
  "avatar_url": "https://cdn.intotes.com/avatars/42.jpg",
  "telegram_verified": false,
  "is_creator": false,
  "is_stats_viewer": false,
  "positions": [],
  "closed_positions": [],
  "closed_positions_has_more": false,
  "total_predictions": 12,
  "biggest_win": 8500,
  "registered_date": "2025-06-15"
}

When viewing another user's public profile, the response omits private fields like email, balance, bonus_balance, referral_code, and wallet addresses.

Response Fields (own profile)

Field	Type	Description
id	int64	User ID
name	string	Display name
nickname	string	Unique username (nullable)
profile_hidden	bool	Whether the user has hidden their profile
email	string	Email address (own profile only)
referral_code	string	Referral code (own profile only)
language	string	Preferred language
theme	string	UI theme preference
balance	int64	Account balance in kopecks (own profile only)
bonus_balance	int64	Bonus balance in kopecks (own profile only)
total_balance	int64	Total balance in kopecks (own profile only)
avatar_url	string	URL of the user's avatar image
is_creator	bool	Whether the user can create events
is_stats_viewer	bool	Whether the user has admin stats access
positions	array	Open positions with details
closed_positions	array	Closed positions with details
total_predictions	int64	Total number of closed positions
biggest_win	int64	Largest PnL win in kopecks
registered_date	string	Registration date in YYYY-MM-DD format

Errors

Status	Code	Description
400	invalid_id	The provided ID is not valid
404	user_not_found	No user exists with this ID