Users

Get current user profile

Changed on

Retrieves the current authenticated user's profile information, including account details and settings. OAuth2 bearer tokens require identify scope, and email is returned only when the email scope is also present. Bearer tokens receive a reduced response: sensitive fields such as MFA status, authenticator types, ACLs, traits, premium billing details, and password metadata are omitted. Session and bot tokens return the full user object with all private fields.

get/users/@me

Request

  • Base URL: https://web.fluxer.app/api/v1
  • URL: https://web.fluxer.app/api/v1/users/@me
  • Auth: one of:
    • API key in header Authorization
    • OAuth 2 (authorization code, authorization URL /oauth2/authorize, token URL /oauth2/token, scopes: identify)
    • API key in header Authorization

Response

Success

idstring snowflake required
usernamestring required

The username of the user, not unique across the platform

discriminatorstring required

The four-digit discriminator tag of the user

global_namestring nullable required

The display name of the user, if set

avatarstring nullable required

The hash of the user avatar image

avatar_colorinteger required
botboolean

Whether the user is a bot account

systemboolean

Whether the user is an official system user

flagsinteger required

The public flags on the user account

mention_flags0 | 1 | 2

Reply mention preference

is_staffboolean required

Whether the user has staff permissions

aclsstring[] required

Access control list entries for the user

traitsstring[] required

Special traits assigned to the user account

emailstring nullable required

The email address associated with the account

email_bouncedboolean

Whether the current email address is marked as bounced by the mail provider

has_verified_phoneboolean required

Deprecated. Always false.

biostring nullable required

The user biography text

pronounsstring nullable required

The preferred pronouns of the user

accent_colorinteger required
timezonestring nullable

The IANA timezone identifier saved by the user

timezone_privacy_flagsinteger

Bitfield controlling who can see the profile timezone

bannerstring nullable required

The hash of the user profile banner image

banner_colorinteger required
mfa_enabledboolean required

Whether multi-factor authentication is enabled

authenticator_typesUserAuthenticatorTypes[]

The types of authenticators configured for MFA

verifiedboolean required

Whether the email address has been verified

account_limitedboolean

Whether the account is limited

premium_type0 | 1 | 2 required

Premium subscription type

premium_sincestring nullable required

ISO8601 timestamp of when premium was first activated

premium_untilstring nullable required

ISO8601 timestamp of when premium access ends, including stacked gift time

premium_will_cancelboolean required

Whether premium is set to cancel at the end of the billing period

premium_billing_cyclestring nullable required

The billing cycle for the premium subscription

premium_lifetime_sequenceinteger required
premium_grace_ends_atstring nullable required

ISO8601 timestamp at which grace access ends after premium_until passes: after a failed renewal payment (7 days from the renewal for monthly plans, 14 for yearly), after a subscription ends (3 days), or during an App Store or Google Play grace period. Perks stay active and the original premium_since is kept on resubscribe until this timestamp passes. Null when no grace is recorded, in which case access lasts 3 days after premium_until.

premium_discriminatorboolean required

Whether the user selected a premium-only discriminator that will be rerolled when non-lifetime premium access ends

premium_badge_hiddenboolean required

Whether the premium badge is hidden on the profile

premium_badge_maskedboolean required

Whether the premium badge shows a masked appearance

premium_badge_timestamp_hiddenboolean required

Whether the premium start timestamp is hidden

premium_badge_sequence_hiddenboolean required

Whether the lifetime sequence number is hidden

premium_purchase_disabledboolean required

Whether premium purchases are disabled for this account

premium_enabled_overrideboolean required

Whether premium features are enabled via override

premium_perks_disabledboolean required

Whether premium perks are temporarily disabled for this account

password_last_changed_atstring nullable required

ISO8601 timestamp of the last password change

last_voice_activity_sharing_change_atstring nullable required

ISO8601 timestamp of the last bulk voice-activity-sharing change. Drives the 24-hour cooldown for re-toggling the Active Now sharing default.

required_actionsstring[] required

Deprecated. Always empty.

nsfw_allowedboolean required

Whether the user is allowed to view NSFW content

has_dismissed_premium_onboardingboolean required

Whether the user has dismissed the premium onboarding flow

has_ever_purchasedboolean required

Whether the user has ever made a purchase

has_unread_gift_inventoryboolean required

Whether there are unread items in the gift inventory

unread_gift_inventory_countinteger required
age_verified_adultboolean

Whether the user has verified their age as an adult via credit card verification

terms_agreed_atstring nullable required

ISO8601 timestamp of when the user last agreed to the terms of service

privacy_agreed_atstring nullable required

ISO8601 timestamp of when the user last agreed to the privacy policy

Changes

  • d94b70c941e3Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

  • dd0ad4ea1c88Revision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      response property avatar list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property banner list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property bio list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property email list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property global_name list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property last_voice_activity_sharing_change_at list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property password_last_changed_at list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property phone list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property premium_billing_cycle list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property premium_grace_ends_at list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property premium_since list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property premium_until list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property privacy_agreed_at list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property pronouns list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property terms_agreed_at list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      response property timezone list-of-types was narrowed by removing types null from media type application/json of response 200