---
title: "Retrieve Current User"
method: GET
path: "/users/me"
tags: ["Users"]
---

# Retrieve Current User

`GET /users/me`

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.

## Query parameters

- `account_id` string
- `include_balance_history` boolean
- `from` string
- `to` string
- `interval` 'hour' | 'day' | 'week' | 'month'
- `time_zone` string

## Response `200`

current user retrieved

- User
  - `balance` UserBalance, required
    - `businesses` UserBalanceBusiness[], required
      - `balance_usd` string, required — The account's total balance in USD.
      - `id` string, required — The account ID, which looks like biz_*************.
      - `logo_url` string, nullable, required — The account's logo URL.
      - `name` string, nullable, required — The account's display name.
    - `businesses_total_usd` string, required — Combined USD balance across every account the user owns.
    - `cash` UserBalanceCash[], required
      - `balance` number, required — Available balance in the native currency.
      - `balance_usd` number, required — Available balance converted to USD.
      - `currency` string, required — Lowercase ISO currency code, such as `usd` or `eur`.
      - `pending_balance_usd` number, required — Pending balance converted to USD.
      - `reserve_balance_usd` number, required — Reserved balance converted to USD.
      - `total_withdrawable_balance` number, required — Withdrawable amount in the native currency.
    - `cash_usd` string, required — Fiat cash in USD, including pending and reserve.
    - `crypto` UserBalanceToken[], required
      - `balance` string, required — Amount held in native token units, as a decimal string.
      - `icon_url` string, nullable, required — Token icon URL.
      - `name` string, nullable, required — The token's display name.
      - `price_usd` number, nullable, required — USD price per token, or `null` when unknown.
      - `symbol` string, required — Token display symbol, such as `USDT`, `XAUT`, or `cbBTC`.
      - `value_usd` number, required — Holding USD value.
    - `crypto_usd` string, required — Crypto holdings in USD.
    - `pending_usd` string, required — Pending funds in USD: fiat pending + in-flight treasury deposits.
    - `total_usd` string, required — The user's personal balance in USD: cash (available + pending + reserve) + crypto + in-flight treasury deposits. Excludes account balances (see businesses_total_usd).
    - `treasury_pending_usd` string, required — Balance-to-wallet USDT0 withdrawals still in flight, in USD.
  - `balance_history` UserBalanceHistory, required
    - `data` UserBalanceHistoryPoint[], required
      - `t` integer, required — Point timestamp, in Unix seconds.
      - `v` number, required — Cumulative wallet balance at this point, in USD.
    - `last` number, required — Value of the most recent point, in USD.
    - `max` number, required — Maximum value across the window, in USD.
    - `min` number, required — Minimum value across the window, in USD.
  - `banner` UserBanner, required
    - `url` string, required — Profile banner image URL.
  - `bio` string, nullable, required — The user's biography
  - `created_at` string, required — When the user was created, as an ISO 8601 timestamp
  - `earnings_usd` UserEarnings, required
    - `first_earned_at` string, nullable, required — The first time the user earned gross income, as an ISO 8601 timestamp.
    - `owned_accounts` UserEarningsAmount, required
      - `last_24_hours` string, required — Gross income in USD over the last 24 hours.
      - `last_30_days` string, required — Gross income in USD over the last 30 days.
      - `last_7_days` string, required — Gross income in USD over the last 7 days.
      - `lifetime` string, required — All-time gross income in USD.
    - `personal` UserEarningsAmount, required
      - `last_24_hours` string, required — Gross income in USD over the last 24 hours.
      - `last_30_days` string, required — Gross income in USD over the last 30 days.
      - `last_7_days` string, required — Gross income in USD over the last 7 days.
      - `lifetime` string, required — All-time gross income in USD.
    - `total` UserEarningsAmount, required
      - `last_24_hours` string, required — Gross income in USD over the last 24 hours.
      - `last_30_days` string, required — Gross income in USD over the last 30 days.
      - `last_7_days` string, required — Gross income in USD over the last 7 days.
      - `lifetime` string, required — All-time gross income in USD.
  - `email` string, nullable, required — 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.
  - `id` string, required — User ID, prefixed `user_`.
  - `name` string, nullable, required — The user's display name
  - `profile_picture` UserProfilePicture, required
    - `url` string, required — Avatar image URL. Always present — a generated placeholder when the user set no picture.
  - `social_accounts` SocialAccount[], required
    - `error` string, nullable, required — Why this social account currently can't be used for advertising — a failed share or a Meta-side restriction. Null when the account is healthy.
    - `external_id` string, nullable, required — The platform-specific ID for this social account.
    - `id` string, required — Unique identifier for the social account.
    - `name` string, nullable, required — The display name of the social account on the platform.
    - `platform` 'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram', required — The platform the social account exists on.
    - `profile_picture_url` string, nullable, required — The URL where the profile picture of the social account can be accessed.
    - `scopes` string[], required
    - `url` string, nullable, required — The URL where the social account can be accessed on the platform. Null while a Whop-owned page is still being provisioned.
    - `username` string, nullable, required — The username of the social account on the platform. Null while a Whop-owned page is still being provisioned.
    - `verified` boolean, required — Whether the social account is verified on the platform.
  - `staff` UserStaffAccess, required
    - `admin` boolean, required — Whether the user holds the admin staff role with a valid second factor.
    - `investigation_access` boolean, required — Whether the user can open Whop-internal investigation tooling right now: a qualifying staff role plus their investigation toggle switched on.
    - `manager` boolean, required — Whether the user holds the manager staff role with a valid second factor.
    - `support` boolean, required — Whether the user holds the support staff role with a valid second factor.
  - `username` string, required — The user's unique username
  - `verification` object, required — 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`.
  - `whop_partner_enabled_at` string, nullable, required — When the user became an enrolled Whop Partner, as an ISO 8601 timestamp. `null` if never enrolled.

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/866821546d67/schema)