---
title: "GET /users/{user_id}"
method: GET
path: "/users/{user_id}"
---

# GET /users/{user_id}

`GET /users/{user_id}`

## Response `200`

200 response for get_user

- UserResponse
  - `id` string, snowflake, required
  - `username` string, required — the user's username, not unique across the platform
  - `avatar` string, nullable, required — the user's avatar hash
  - `discriminator` string, required — the user's Discord-tag
  - `public_flags` integer, required — the public flags on a user's account
  - `flags` integer, required
  - `bot` boolean — whether the user belongs to an OAuth2 application
  - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system)
  - `banner` string, nullable — the user's banner hash
  - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code
  - `global_name` string, nullable, required — the user's display name, if it is set
  - `avatar_decoration_data` UserAvatarDecorationResponse
    - `asset` string, required — the avatar decoration hash
    - `sku_id` string, snowflake, required
  - `collectibles` UserCollectiblesResponse
    - `nameplate` UserNameplateResponse, required
      - `sku_id` string, snowflake, required
      - `asset` string, required — Path to the nameplate asset
      - `label` string, required — The label of this nameplate. Currently unused
      - `palette` union, required
        - 'crimson' — Crimson color palette
        - 'berry' — Berry color palette
        - 'sky' — Sky color palette
        - 'teal' — Teal color palette
        - 'forest' — Forest color palette
        - 'bubble_gum' — Bubble gum color palette
        - 'violet' — Violet color palette
        - 'cobalt' — Cobalt color palette
        - 'clover' — Clover color palette
        - 'lemon' — Lemon color palette
        - 'white' — White color palette
        - 'black' — Black color palette
  - `primary_guild` UserPrimaryGuildResponse, required
    - `identity_guild_id` string, snowflake, required
    - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag
    - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters
    - `badge` string, nullable, required — the server tag badge hash

## Other responses

- `429` — Client ratelimited response
- `4XX` — Client error response

## Changes

> 58 revisions in range; 4 could not be searched.

- **2026-06-05** `693bf1f99bba` — 1 breaking
  - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200`
- **2026-02-04** `e200830e509a` — 10 info
  - the response property `avatar` became required for the status `200`
  - the response property `avatar_decoration_data/oneOf[#/components/schemas/UserAvatarDecorationResponse]/sku_id` became required for the status `200`
  - the response property `collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate` became required for the status `200`
  - the response property `collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/sku_id` became required for the status `200`
  - …6 more

[Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/users/:user_id/get.md)

---

[API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)