---
title: "Get user profile"
method: GET
path: "/users/{target_id}/profile"
tags: ["Users"]
---

# Get user profile

`GET /users/{target_id}/profile`

Retrieves detailed profile information for a user, including bio, custom status, and badges. Optionally includes mutual friends and mutual guilds if requested. May respect privacy settings.

## Path parameters

- `target_id` string, required

## Query parameters

- `guild_id` string, snowflake
- `with_mutual_friends` string — Whether to include mutual friends
- `with_mutual_guilds` string — Whether to include mutual guilds

## Response `200`

Success

- UserProfileFullResponse
  - `user` object, required — The user object
    - `id` string, required — The unique identifier (snowflake) for this user
    - `username` string, required — The username of the user, not unique across the platform
    - `discriminator` string, required — The four-digit discriminator tag of the user
    - `global_name` string, nullable, required — The display name of the user, if set
    - `avatar` string, nullable, required — The hash of the user avatar image
    - `avatar_color` integer, required
    - `bot` boolean — Whether the user is a bot account
    - `system` boolean — Whether the user is an official system user
    - `flags` integer, required — The public flags on the user account
    - `mention_flags` 0 | 1 | 2 — Reply mention preference
  - `user_profile` object, required — The user profile data
    - `bio` string, nullable, required — User biography text
    - `pronouns` string, nullable, required — User pronouns
    - `banner` string, nullable, required — Hash of the profile banner image
    - `banner_color` integer
    - `accent_color` integer, required
  - `guild_member` GuildMemberResponse
    - `user` UserPartialResponse, required
      - `id` string, required — The unique identifier (snowflake) for this user
      - `username` string, required — The username of the user, not unique across the platform
      - `discriminator` string, required — The four-digit discriminator tag of the user
      - `global_name` string, nullable, required — The display name of the user, if set
      - `avatar` string, nullable, required — The hash of the user avatar image
      - `avatar_color` integer, required
      - `bot` boolean — Whether the user is a bot account
      - `system` boolean — Whether the user is an official system user
      - `flags` integer, required — The public flags on the user account
      - `mention_flags` 0 | 1 | 2 — Reply mention preference
    - `nick` string, nullable — The nickname of the member in this guild
    - `avatar` string, nullable — The hash of the member guild-specific avatar
    - `banner` string, nullable — The hash of the member guild-specific banner
    - `accent_color` integer
    - `roles` string[], required — Array of role IDs the member has
    - `joined_at` string, date-time, required — ISO8601 timestamp of when the user joined the guild
    - `mute` boolean, required — Whether the member is muted in voice channels
    - `deaf` boolean, required — Whether the member is deafened in voice channels
    - `communication_disabled_until` string, date-time, nullable — ISO8601 timestamp until which the member is timed out
    - `profile_flags` integer — Member profile flags
    - `mention_flags` 0 | 1 | 2 — Reply mention preference
  - `guild_member_profile` object, nullable — Guild-specific profile data
    - `bio` string, nullable, required — Guild-specific biography text
    - `pronouns` string, nullable, required — Guild-specific pronouns
    - `banner` string, nullable, required — Hash of the guild-specific banner image
    - `accent_color` integer, required
  - `premium_type` 0 | 1 | 2 — Premium subscription type
  - `premium_since` string — ISO8601 timestamp of when premium was activated
  - `premium_lifetime_sequence` integer
  - `mutual_friends` UserPartialResponse[] — Array of mutual friends
    - `id` string, required — The unique identifier (snowflake) for this user
    - `username` string, required — The username of the user, not unique across the platform
    - `discriminator` string, required — The four-digit discriminator tag of the user
    - `global_name` string, nullable, required — The display name of the user, if set
    - `avatar` string, nullable, required — The hash of the user avatar image
    - `avatar_color` integer, required
    - `bot` boolean — Whether the user is a bot account
    - `system` boolean — Whether the user is an official system user
    - `flags` integer, required — The public flags on the user account
    - `mention_flags` 0 | 1 | 2 — Reply mention preference
  - `mutual_guilds` object[] — Array of mutual guilds
    - `id` string, required — The ID of the mutual guild
    - `nick` string, nullable, required — The nickname of the target user in this guild
  - `connected_accounts` ConnectionResponse[] — Array of verified external connections
    - `id` string, required — The unique identifier for this connection
    - `type` 'bsky' | 'domain', required — The type of connection
    - `name` string, required — The display name of the connection (handle or domain)
    - `verified` boolean, required — Whether the connection has been verified
    - `visibility_flags` integer, required — Bitfield controlling who can see this connection
    - `sort_order` integer, required — The display order of this connection
  - `timezone_offset` integer, nullable, required — Current timezone offset in minutes from UTC for the target user's profile timezone, or null when hidden or unset
  - `profile_limited` boolean — True when the target user has restricted their profile and the viewer does not meet the visibility tier; bio, pronouns, badges, and connected accounts have been stripped.

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `401` — Unauthorized - Authentication is required or the token is invalid
- `403` — Forbidden - You do not have permission to perform this action
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

---

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