---
title: "Changes to Get a user by external_id"
method: GET
path: "/u/by-external/{external_id}.json"
---

# Changes to Get a user by external_id

`GET /u/by-external/{external_id}.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 20 of 52 revisions.

- **2026-10-07** `33cf9fceddc2`: 4 info
- **2026-09-23** `aa525bcf6bef`: 1 info
- **2026-08-27** `2fd8fd2d6fd0`: 1 breaking
- **2026-08-05** `fb966f5bb63e`: 1 breaking
- **2026-07-31** `da2f153be6e6`: 3 info
- **2026-07-26** `6be3dcbee910`: 1 info
- **2026-06-08** `4c4a6f2d6793`: 1 breaking, 6 info
- **2026-04-27** `fdca867aa083`: 1 info
- **2026-02-15** `a0c433b1f857`: 1 info
- **2025-10-27** `8393fa61d3e0`: 1 info
- **2025-10-14** `e90da7406181`: 3 info
- **2024-11-26** `3d343acfc1c5`: 3 info
- **2024-08-13** `7153cdbbf109`: 3 breaking, 2 info
- **2024-04-08** `651b57b68bc7`: 1 info
- **2024-04-03** `91dbbfa4ffd0`: 1 info
- **2024-01-27** `2df0ac845943`: 4 info
- **2023-08-11** `7b91dc8ad5ad`: 1 warning, 3 info
- **2022-12-21** `789fc40f66ad`: 1 info
- **2022-11-24** `1a99c14f514c`: 2 info
- **2022-03-05** `e1108b0434c0`: 20 breaking, 5 warning, 59 info

## Changes

- **2026-10-07** `33cf9fceddc2`: 4 info
  - added the required property `user/associated_account_avatars` to the response with the `200` status
  - added the required property `user/can_edit_avatar` to the response with the `200` status
  - added the required property `user/can_upload_avatar` to the response with the `200` status
  - added the required property `user/selected_user_associated_account_id` to the response with the `200` status
- **2026-09-23** `aa525bcf6bef`: 1 info
  - added the required property `user/user_option/hidden_composer_toolbar_buttons` to the response with the `200` status
- **2026-08-27** `2fd8fd2d6fd0`: 1 breaking
  - removed the required property `user/user_option/topics_unread_when_closed` from the response with the `200` status
- **2026-08-05** `fb966f5bb63e`: 1 breaking
  - removed the required property `user/user_option/enable_defer` from the response with the `200` status
- **2026-07-31** `da2f153be6e6`: 3 info
  - added the required property `user/user_option/automatically_translate` to the response with the `200` status
  - added the required property `user/user_option/send_shortcut` to the response with the `200` status
  - added the required property `user/user_option/understood_languages` to the response with the `200` status
- **2026-07-26** `6be3dcbee910`: 1 info
  - added the required property `user/user_option/push_notification_level` to the response with the `200` status
- **2026-06-08** `4c4a6f2d6793`: 1 breaking, 6 info
  - the `user/featured_topic` response's property type changed from `string, null` to `object` for status `200`
  - added the required property `user/featured_topic/fancy_title` to the response with the `200` status
  - added the required property `user/featured_topic/id` to the response with the `200` status
  - added the required property `user/featured_topic/posts_count` to the response with the `200` status
  - added the required property `user/featured_topic/slug` to the response with the `200` status
  - added the required property `user/featured_topic/title` to the response with the `200` status
  - added the required property `user/user_option/enable_upcoming_change_available_notifications` to the response with the `200` status
- **2026-04-27** `fdca867aa083`: 1 info
  - added the required property `user/user_option/show_original_content` to the response with the `200` status
- **2026-02-15** `a0c433b1f857`: 1 info
  - added the required property `user/topic_count` to the response with the `200` status
- **2025-10-27** `8393fa61d3e0`: 1 info
  - added the required property `user/user_option/notify_on_linked_posts` to the response with the `200` status
- **2025-10-14** `e90da7406181`: 3 info
  - added the optional property `user/user_option/composition_mode` to the response with the `200` status
  - added the required property `user/user_option/enable_markdown_monospace_font` to the response with the `200` status
  - added the required property `user/user_option/interface_color_mode` to the response with the `200` status
- **2024-11-26** `3d343acfc1c5`: 3 info
  - added the required property `user/user_option/enable_smart_lists` to the response with the `200` status
  - added the required property `user/user_option/hide_presence` to the response with the `200` status
  - added the required property `user/user_option/hide_profile` to the response with the `200` status
- **2024-08-13** `7153cdbbf109`: 3 breaking, 2 info
  - the `user/flair_group_id` response's property type changed from `string, null` to `integer, null` for status `200`
  - the `user/primary_group_id` response's property type changed from `string, null` to `integer, null` for status `200`
  - the `user/uploaded_avatar_id` response's property type changed from `string, null` to `integer, null` for status `200`
  - added the optional property `user/can_ignore_users` to the response with the `200` status
  - added the optional property `user/can_mute_users` to the response with the `200` status
- **2024-04-08** `651b57b68bc7`: 1 info
  - added the optional property `user/can_pick_theme_with_custom_homepage` to the response with the `200` status
- **2024-04-03** `91dbbfa4ffd0`: 1 info
  - added the required property `user/user_option/topics_unread_when_closed` to the response with the `200` status
- **2024-01-27** `2df0ac845943`: 4 info
  - added the optional property `user/display_sidebar_tags` to the response with the `200` status
  - added the optional property `user/sidebar_category_ids` to the response with the `200` status
  - added the optional property `user/sidebar_tags` to the response with the `200` status
  - added the optional property `user/user_passkeys` to the response with the `200` status
- **2023-08-11** `7b91dc8ad5ad`: 1 warning, 3 info
  - removed the optional property `user/user_option/sidebar_list_destination` from the response with the `200` status
  - added the optional property `user/user_option/sidebar_link_to_filtered_list` to the response with the `200` status
  - added the optional property `user/user_option/sidebar_show_count_of_new_items` to the response with the `200` status
  - added the optional property `user/user_option/watched_precedence_over_muted` to the response with the `200` status
- **2022-12-21** `789fc40f66ad`: 1 info
  - added the optional property `user/user_option/bookmark_auto_delete_preference` to the response with the `200` status
- **2022-11-24** `1a99c14f514c`: 2 info
  - added the optional property `user/user_option/seen_popups` to the response with the `200` status
  - added the optional property `user/user_option/sidebar_list_destination` to the response with the `200` status
- **2022-03-05** `e1108b0434c0`: 20 breaking, 5 warning, 59 info
  - added the new required `header` request parameter `Api-Key`
  - added the new required `header` request parameter `Api-Username`
  - the response's body type changed from `object` to no type for status `200`
  - the response property `user/invited_by` became nullable for the status `200`
  - the response property `user/last_posted_at` became nullable for the status `200`
  - the response property `user/last_seen_at` became nullable for the status `200`
  - the response property `user/primary_group_name` became nullable for the status `200`
  - the response property `user/title` became nullable for the status `200`
  - the response property `user/uploaded_avatar_id` became nullable for the status `200`
  - the `user/groups` response property's minItems was decreased from `1` to `0` for the response status `200`
  - the `user/avatar_template` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `user/created_at` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `user/last_posted_at` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `user/last_seen_at` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `user/username` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `user/invited_by` response's property type changed from `object` to `string, null` for status `200`
  - the `user/name` response's property type changed from `object` to `string` for status `200`
  - the `user/primary_group_name` response's property type changed from `object` to `string, null` for status `200`
  - the `user/title` response's property type changed from `object` to `string, null` for status `200`
  - the `user/uploaded_avatar_id` response's property type changed from `object` to `string, null` for status `200`
  - removed the optional property `user/card_badge` from the response with the `200` status
  - removed the optional property `user/primary_group_flair_bg_color` from the response with the `200` status
  - removed the optional property `user/primary_group_flair_color` from the response with the `200` status
  - removed the optional property `user/primary_group_flair_url` from the response with the `200` status
  - removed the optional property `user/website_name` from the response with the `200` status
  - api operation id `getUserExternalId` was added
  - added the optional property `user/custom_fields/first_name` to the response with the `200` status
  - added the optional property `user/pending_posts_count` to the response with the `200` status
  - added the optional property `user/second_factor_backup_enabled` to the response with the `200` status
  - added the optional property `user/user_fields` to the response with the `200` status
  - the response property `user` became required for the status `200`
  - the response property `user/invited_by` became required for the status `200`
  - the response property `user/name` became required for the status `200`
  - the response property `user/primary_group_name` became required for the status `200`
  - the response property `user/title` became required for the status `200`
  - the response property `user/uploaded_avatar_id` became required for the status `200`
  - the response property `user_badges` became required for the status `200`
  - added the required property `user/allowed_pm_usernames` to the response with the `200` status
  - added the required property `user/can_be_deleted` to the response with the `200` status
  - added the required property `user/can_change_bio` to the response with the `200` status
  - …44 more

---

[Operation](https://skmtc.dev/discourse/apis/discourse-api-documentation/docs/u/by-external/:external_id.json/get.md) - [API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) - [Page](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/u/by-external/:external_id.json/get)
