Skip to main content

Players

Player profile and account management endpoints.

Base URL: https://proxy.bettoredge.com

Get Player Profile​

GET players/player/me

Get the current authenticated player's profile

Authentication: Required - Include Bearer token in Authorization header

Authorization: Bearer <token>

Response​

Status: 200 OK

Body: GetPlayerProfileResponse

Example Response
{
  "message": "example",
  "player": {
    "player_id": "example",
    "profile_pic": "example",
    "username": "example",
    "first_name": "example",
    "last_name": "example",
    "guide_me": true,
    "email": "example",
    "type": "premium",
    "anonymous": true,
    "role": "player",
    "dob": "example",
    "auto_generated": true,
    "company_id": "example",
    "no_password": true,
    "open_to_challenges": true,
    "verified": true,
    "phone": "example",
    "phone_verified": true,
    "vouched_status": "verified",
    "bio": "example",
    "terms_agreed_on": null,
    "create_datetime": null,
    "last_update_datetime": null
  },
  "player_premium_items": []
}
Response Properties
  • message (string)
  • player (MyPlayerProps)
    • player_id (string) - Unique player identifier
    • profile_pic (string) - URL to profile picture
    • username (string) - Player's unique username
    • first_name (string) - Player's first name
    • last_name (string) - Player's last name
    • guide_me (optional) (boolean | undefined) - Optional flag to guide new users through app features
    • email (string) - Player's email address
    • type ("premium" | "freemium") - Account subscription level
    • anonymous (boolean) - Whether this is an anonymous account
    • role ("player" | "admin") - User role in the system
    • dob (optional) (string | undefined) - Optional date of birth (YYYY-MM-DD format)
    • auto_generated (boolean) - Whether account was auto-generated by the system
    • company_id (optional) (string | undefined) - Optional company ID for white-label users
    • no_password (boolean) - Whether account has no password (OAuth only)
    • open_to_challenges (boolean) - Whether player accepts head-to-head challenges
    • verified (boolean) - Whether email is verified
    • phone (string) - Player's phone number
    • phone_verified (boolean) - Whether phone number is verified
    • vouched_status ("verified" | "unverified" | "failed" | "reverify") - Identity verification status
    • bio (optional) (string | undefined) - Optional player bio/description
    • terms_agreed_on (optional) (any) - Timestamp when terms were agreed to
    • create_datetime (any) - Timestamp when account was created
    • last_update_datetime (any) - Timestamp of last profile update
  • player_premium_items (any[])

Error Responses​

  • Error if not authenticated or if the request fails

Get Player Balance​

GET players/player/balance/me

Get the current authenticated player's balance

Authentication: Required - Include Bearer token in Authorization header

Authorization: Bearer <token>

Response​

Status: 200 OK

Body: GetPlayerBalanceResponse

Example Response
{
  "message": "example",
  "player_balance": {
    "player_balance_id": "example",
    "player_id": "example",
    "free_market_balance": 100,
    "balance": 100,
    "promo_balance": 100,
    "create_datetime": null,
    "last_udpate_datetime": null
  }
}
Response Properties
  • message (string)
  • player_balance (PlayerBalanceProps)
    • player_balance_id (string) - Unique player balance record ID
    • player_id (string) - Associated player ID
    • free_market_balance (number) - Free play market balance (play money)
    • balance (number) - Real money balance available for trading
    • promo_balance (number) - Promotional balance (bonus funds)
    • create_datetime (any) - Timestamp when balance record was created
    • last_udpate_datetime (any) - Timestamp of last balance update

Error Responses​

  • Error if not authenticated or if the request fails