OAuth2

Get OAuth2 user information

Retrieves authenticated user information using a valid access token. Requires identify scope and supports email scope for email fields.

get/oauth2/userinfo

Response

Success

substring snowflake required

idstring snowflake required

usernamestring required

The username of the user

discriminatorstring required

The discriminator of the user

global_namestring nullable required

The global display name of the user

avatarstring nullable required

The avatar hash of the user

emailstring nullable

The email address of the user

verifiedboolean nullable

Whether the user has verified their email

flagsinteger

The public flags on the user account

Changes

Changed in 4 of the 21 revisions of this API.41616

Sep 18, 2026dd0ad4ea1c8844See the full diff
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ○
  response property avatar list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property email list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property global_name list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property verified list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
Sep 6, 2026a52a2cf49d9b16See the full diff
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Sep 5, 20264dbb738a3e222See the full diff
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
Sep 3, 2026fa36b1b48ca510See the full diff
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 21 revisions, 2 have no diff computed.

Full history