# Get a single user by username

`GET /u/{username}.json`

Authentication: no security requirement declared for this operation.

Parameters:

- `Api-Key` (header, string, required)
  Type: string

- `Api-Username` (header, string, required)
  Type: string

- `username` (path, string, required)
  Type: string

Responses:

- 200: user with primary group response

Content type: application/json

Type: any

- `user_badges` (required)
  Type: Array<any>
  
  Items:
    Type: any

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

Additional properties: false

## Examples

### cURL

```bash
curl -X GET 'https://discourse.example.com/u/string.json' \
  -H 'Api-Key: string' \
  -H 'Api-Username: string'
```

### JavaScript

```javascript
const response = await fetch('https://discourse.example.com/u/string.json', {
  method: 'GET',
  headers: {
    'Api-Key': 'string',
    'Api-Username': 'string',
  },
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get(
    'https://discourse.example.com/u/string.json',
    headers={
        'Api-Key': 'string',
        'Api-Username': 'string',
    },
)
print(response.text)
```