Retrieve Current User
Retrieves the authenticated user — the self view of the user object. Same shape as GET /users/{id}, with the self-only fields populated: email (email-read scope), staff (Whop staff only, staff-read scope), balance and earnings_usd (balance-read scope), the opt-in balance_history, and every linked social account.
Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
Pins the request to a dated API version.
"2026-07-22"
Query Parameters
When set, returns your account-specific profile overrides for this account.
Also compute your balance history (opt-in; runs a heavier query). Ignored for callers without balance-read scope.
Balance-history window start, ISO 8601 date or datetime. Defaults to 30 days ago. Only used with include_balance_history.
Balance-history window end, ISO 8601 date or datetime. Defaults to now. Only used with include_balance_history.
Balance-history point granularity. Defaults to day. Only used with include_balance_history.
hour, day, week, month IANA time zone the balance-history points are bucketed in. Defaults to UTC. Only used with include_balance_history.
Response
current user retrieved
The user's balance: personal cash + crypto + in-flight treasury deposits, plus account balances for accounts they own. Computed only on GET /users/me self-view for callers with balance-read scope; null otherwise.
The user's cumulative wallet balance over time (USD { t, v } points plus last/min/max), for the balance chart. Opt in with include_balance_history=true on GET /users/me; populated only for callers with balance-read scope and null otherwise. A user with no wallet activity returns an empty series.
The user's biography
When the user was created, as an ISO 8601 timestamp
The user's gross USD income over time. Populated only on single-user self reads for callers with balance-read scope; null otherwise.
The user's email address. Populated only on GET /users/me self-view for callers with email-read scope; null otherwise, or while the account has no confirmed email yet.
User ID, prefixed user_.
The user's display name
The user's profile picture, an object with a url
Whop staff access flags. Populated only on GET /users/me self-view for callers with staff-read scope; null there for every user who is not Whop staff, and always null elsewhere.
The user's unique username
Identity verification status for the user's individual (KYC) and business (KYB) profiles. Each is null until created, otherwise a status of not_started, pending, approved, or rejected.
When the user became an enrolled Whop Partner, as an ISO 8601 timestamp. null if never enrolled.

