Retrieve User
Retrieves a user’s public profile by user_ tag, username, or ‘me’.
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-20"
Path Parameters
User ID (prefixed user_), username, or me.
Query Parameters
When set, returns the user's account-specific profile overrides for this account.
On GET /users/me, also compute the caller's balance history (opt-in; runs a heavier query). Ignored for other users and 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
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.
User ID, prefixed user_.
The user's display name
The user's profile picture, an object with a url
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.

