---
title: "Get a single user by username"
method: GET
path: "/u/{username}.json"
tags: ["Users"]
---

# Get a single user by username

`GET /u/{username}.json`

## Path parameters

- `username` string, required

## Headers

- `Api-Key` string, required
- `Api-Username` string, required

## Response `200`

user with primary group response

- object
  - `user_badges` unknown[], required
    - unknown
  - `user` object, required
    - `id` integer, required
    - `username` string, required
    - `name` string, required
    - `avatar_template` string, required
    - `last_posted_at` string, nullable, required
    - `last_seen_at` string, nullable, required
    - `created_at` string, required
    - `ignored` boolean, required
    - `muted` boolean, required
    - `can_ignore_user` boolean, required
    - `can_ignore_users` boolean
    - `can_mute_user` boolean, required
    - `can_mute_users` boolean
    - `can_send_private_messages` boolean, required
    - `can_send_private_message_to_user` boolean, required
    - `trust_level` integer, required
    - `moderator` boolean, required
    - `admin` boolean, required
    - `title` string, nullable, required
    - `badge_count` integer, required
    - `second_factor_backup_enabled` boolean
    - `user_fields` object
      - `1` string, nullable, required
      - `2` string, nullable, required
    - `custom_fields` object, required
      - `first_name` string, nullable
    - `time_read` integer, required
    - `recent_time_read` integer, required
    - `primary_group_id` integer, nullable, required
    - `primary_group_name` string, nullable, required
    - `flair_group_id` integer, nullable, required
    - `flair_name` string, nullable, required
    - `flair_url` string, nullable, required
    - `flair_bg_color` string, nullable, required
    - `flair_color` string, nullable, required
    - `featured_topic` object, required
      - `id` integer, required
      - `title` string, required
      - `fancy_title` string, required
      - `slug` string, required
      - `posts_count` integer, required
    - `staged` boolean, required
    - `can_edit` boolean, required
    - `can_edit_username` boolean, required
    - `can_edit_email` boolean, required
    - `can_edit_name` boolean, required
    - `uploaded_avatar_id` integer, nullable, required
    - `has_title_badges` boolean, required
    - `pending_count` integer, required
    - `pending_posts_count` integer
    - `profile_view_count` integer, required
    - `second_factor_enabled` boolean, required
    - `can_upload_profile_header` boolean, required
    - `can_upload_user_card_background` boolean, required
    - `post_count` integer, required
    - `topic_count` integer, required
    - `can_be_deleted` boolean, required
    - `can_delete_all_posts` boolean, required
    - `locale` string, nullable, required
    - `muted_category_ids` unknown[], required
      - unknown
    - `regular_category_ids` unknown[], required
      - unknown
    - `watched_tags` unknown[], required
      - unknown
    - `watching_first_post_tags` unknown[], required
      - unknown
    - `tracked_tags` unknown[], required
      - unknown
    - `muted_tags` unknown[], required
      - unknown
    - `tracked_category_ids` unknown[], required
      - unknown
    - `watched_category_ids` unknown[], required
      - unknown
    - `watched_first_post_category_ids` unknown[], required
      - unknown
    - `system_avatar_upload_id` string, nullable, required
    - `system_avatar_template` string, required
    - `muted_usernames` unknown[], required
      - unknown
    - `ignored_usernames` unknown[], required
      - unknown
    - `allowed_pm_usernames` unknown[], required
      - unknown
    - `mailing_list_posts_per_day` integer, required
    - `can_change_bio` boolean, required
    - `can_change_location` boolean, required
    - `can_change_website` boolean, required
    - `can_change_tracking_preferences` boolean, required
    - `user_api_keys` string, nullable, required
    - `user_passkeys` unknown[]
      - unknown
    - `sidebar_tags` unknown[]
      - unknown
    - `sidebar_category_ids` unknown[]
      - unknown
    - `display_sidebar_tags` boolean
    - `can_pick_theme_with_custom_homepage` boolean
    - `user_auth_tokens` object[], required
      - `id` integer, required
      - `client_ip` string, required
      - `location` string, required
      - `browser` string, required
      - `device` string, required
      - `os` string, required
      - `icon` string, required
      - `created_at` string, required
      - `seen_at` string, required
      - `is_active` boolean, required
    - `user_notification_schedule` object, required
      - `enabled` boolean, required
      - `day_0_start_time` integer, required
      - `day_0_end_time` integer, required
      - `day_1_start_time` integer, required
      - `day_1_end_time` integer, required
      - `day_2_start_time` integer, required
      - `day_2_end_time` integer, required
      - `day_3_start_time` integer, required
      - `day_3_end_time` integer, required
      - `day_4_start_time` integer, required
      - `day_4_end_time` integer, required
      - `day_5_start_time` integer, required
      - `day_5_end_time` integer, required
      - `day_6_start_time` integer, required
      - `day_6_end_time` integer, required
    - `use_logo_small_as_avatar` boolean, required
    - `featured_user_badge_ids` unknown[], required
      - unknown
    - `invited_by` string, nullable, required
    - `groups` object[], required
      - `id` integer, required
      - `automatic` boolean, required
      - `name` string, required
      - `display_name` string, required
      - `user_count` integer, required
      - `mentionable_level` integer, required
      - `messageable_level` integer, required
      - `visibility_level` integer, required
      - `primary_group` boolean, required
      - `title` string, nullable, required
      - `grant_trust_level` string, nullable, required
      - `incoming_email` string, nullable, required
      - `has_messages` boolean, required
      - `flair_url` string, nullable, required
      - `flair_bg_color` string, nullable, required
      - `flair_color` string, nullable, required
      - `bio_raw` string, nullable, required
      - `bio_cooked` string, nullable, required
      - `bio_excerpt` string, nullable, required
      - `public_admission` boolean, required
      - `public_exit` boolean, required
      - `allow_membership_requests` boolean, required
      - `full_name` string, nullable, required
      - `default_notification_level` integer, required
      - `membership_request_template` string, nullable, required
      - `members_visibility_level` integer, required
      - `can_see_members` boolean, required
      - `can_admin_group` boolean, required
      - `publish_read_state` boolean, required
    - `group_users` object[], required
      - `group_id` integer, required
      - `user_id` integer, required
      - `notification_level` integer, required
      - `owner` boolean
    - `user_option` object, required
      - `user_id` integer, required
      - `mailing_list_mode` boolean, required
      - `mailing_list_mode_frequency` integer, required
      - `email_digests` boolean, required
      - `email_level` integer, required
      - `email_messages_level` integer, required
      - `external_links_in_new_tab` boolean, required
      - `bookmark_auto_delete_preference` integer
      - `color_scheme_id` string, nullable, required
      - `dark_scheme_id` string, nullable, required
      - `dynamic_favicon` boolean, required
      - `enable_quoting` boolean, required
      - `enable_smart_lists` boolean, required
      - `enable_markdown_monospace_font` boolean, required
      - `digest_after_minutes` integer, required
      - `automatically_unpin_topics` boolean, required
      - `auto_track_topics_after_msecs` integer, required
      - `notification_level_when_replying` integer, required
      - `new_topic_duration_minutes` integer, required
      - `email_previous_replies` integer, required
      - `email_in_reply_to` boolean, required
      - `like_notification_frequency` integer, required
      - `notify_on_linked_posts` boolean, required
      - `push_notification_level` string, required
      - `enable_upcoming_change_available_notifications` boolean, required
      - `include_tl0_in_digests` boolean, required
      - `theme_ids` unknown[], required
        - unknown
      - `theme_key_seq` integer, required
      - `allow_private_messages` boolean, required
      - `enable_allowed_pm_users` boolean, required
      - `homepage_id` string, nullable, required
      - `hide_profile_and_presence` boolean, required
      - `hide_profile` boolean, required
      - `hide_presence` boolean, required
      - `text_size` string, required
      - `text_size_seq` integer, required
      - `title_count_mode` string, required
      - `timezone` string, nullable, required
      - `skip_new_user_tips` boolean, required
      - `default_calendar` string
      - `oldest_search_log_date` string, nullable
      - `sidebar_link_to_filtered_list` boolean
      - `sidebar_show_count_of_new_items` boolean
      - `watched_precedence_over_muted` boolean
      - `seen_popups` unknown
      - `topics_unread_when_closed` boolean, required
      - `composition_mode` integer
      - `interface_color_mode` integer, required
      - `automatically_translate` boolean, required
      - `understood_languages` string[], required
      - `show_original_content` boolean, required
      - `send_shortcut` string, required

---

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