Admin

Get a user by id

GET

https://discourse.example.com/admin/users/{id}.json

Get a user by id

curl -X GET 'https://discourse.example.com/admin/users/0.json'

const response = await fetch('https://discourse.example.com/admin/users/0.json', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://discourse.example.com/admin/users/0.json')
print(response.text)

200

{
  "id": 0,
  "username": "string",
  "name": "string",
  "avatar_template": "string",
  "active": true,
  "admin": true,
  "moderator": true,
  "last_seen_at": "string",
  "last_emailed_at": "string",
  "created_at": "string",
  "last_seen_age": 0,
  "last_emailed_age": 0,
  "created_at_age": 0,
  "trust_level": 0,
  "manual_locked_trust_level": "string",
  "title": "string",
  "time_read": 0,
  "staged": true,
  "days_visited": 0,
  "posts_read_count": 0,
  "topics_entered": 0,
  "post_count": 0,
  "associated_accounts": [],
  "can_send_activation_email": true,
  "can_activate": true,
  "can_deactivate": true,
  "can_change_trust_level": true,
  "ip_address": "string",
  "registration_ip_address": "string",
  "can_grant_admin": true,
  "can_revoke_admin": true,
  "can_grant_moderation": true,
  "can_revoke_moderation": true,
  "can_impersonate": true,
  "like_count": 0,
  "like_given_count": 0,
  "topic_count": 0,
  "flags_given_count": 0,
  "flags_received_count": 0,
  "private_topics_count": 0,
  "can_delete_all_posts": true,
  "can_be_deleted": true,
  "can_be_anonymized": true,
  "can_be_merged": true,
  "full_suspend_reason": "string",
  "latest_export": {},
  "full_silence_reason": "string",
  "silence_reason": "string",
  "post_edits_count": 0,
  "primary_group_id": 0,
  "badge_count": 0,
  "warnings_received_count": 0,
  "bounce_score": 0,
  "reset_bounce_score_after": "string",
  "can_view_action_logs": true,
  "can_disable_second_factor": true,
  "can_delete_sso_record": true,
  "api_key_count": 0,
  "similar_users_count": 0,
  "single_sign_on_record": "string",
  "approved_by": {
    "id": 0,
    "username": "string",
    "name": "string",
    "avatar_template": "string"
  },
  "suspended_by": "string",
  "silenced_by": "string",
  "penalty_counts": {
    "silenced": 0,
    "suspended": 0
  },
  "next_penalty": "string",
  "tl3_requirements": {
    "time_period": 0,
    "requirements_met": true,
    "requirements_lost": true,
    "trust_level_locked": true,
    "on_grace_period": true,
    "days_visited": 0,
    "min_days_visited": 0,
    "num_topics_replied_to": 0,
    "min_topics_replied_to": 0,
    "topics_viewed": 0,
    "min_topics_viewed": 0,
    "posts_read": 0,
    "min_posts_read": 0,
    "topics_viewed_all_time": 0,
    "min_topics_viewed_all_time": 0,
    "posts_read_all_time": 0,
    "min_posts_read_all_time": 0,
    "num_flagged_posts": 0,
    "max_flagged_posts": 0,
    "num_flagged_by_users": 0,
    "max_flagged_by_users": 0,
    "num_likes_given": 0,
    "min_likes_given": 0,
    "num_likes_received": 0,
    "min_likes_received": 0,
    "num_likes_received_days": 0,
    "min_likes_received_days": 0,
    "num_likes_received_users": 0,
    "min_likes_received_users": 0,
    "penalty_counts": {
      "silenced": 0,
      "suspended": 0,
      "total": 0
    }
  },
  "groups": [
    {
      "id": 0,
      "automatic": true,
      "name": "string",
      "display_name": "string",
      "user_count": 0,
      "mentionable_level": 0,
      "messageable_level": 0,
      "visibility_level": 0,
      "primary_group": true,
      "title": "string",
      "grant_trust_level": "string",
      "incoming_email": "string",
      "has_messages": true,
      "flair_url": "string",
      "flair_bg_color": "string",
      "flair_color": "string",
      "flair_group_id": 0,
      "bio_raw": "string",
      "bio_cooked": "string",
      "bio_excerpt": "string",
      "public_admission": true,
      "public_exit": true,
      "allow_membership_requests": true,
      "full_name": "string",
      "default_notification_level": 0,
      "membership_request_template": "string",
      "members_visibility_level": 0,
      "can_see_members": true,
      "can_admin_group": true,
      "publish_read_state": true
    }
  ],
  "external_ids": {},
  "include_ip": true,
  "upcoming_changes_stats": [
    {
      "name": "string",
      "humanized_name": "string",
      "description": "string",
      "enabled": true,
      "specific_groups": [
        "string"
      ],
      "reason": "enabled_for_everyone"
    }
  ]
}

Parameters

idintegerrequiredpath

Response

200OKany

response

Response fields application/json

idintegerrequired

usernamestringrequired

namestring | nullrequired

avatar_templatestringrequired

activebooleanrequired

adminbooleanrequired

moderatorbooleanrequired

last_seen_atstring | nullrequired

last_emailed_atstring | nullrequired

created_atstringrequired

last_seen_agenumber | nullrequired

last_emailed_agenumber | nullrequired

created_at_agenumber | nullrequired

trust_levelintegerrequired

manual_locked_trust_levelstring | nullrequired

titlestring | nullrequired

time_readintegerrequired

stagedbooleanrequired

days_visitedintegerrequired

posts_read_countintegerrequired

topics_enteredintegerrequired

post_countintegerrequired

associated_accountsArray<any>

can_send_activation_emailbooleanrequired

can_activatebooleanrequired

can_deactivatebooleanrequired

can_change_trust_levelboolean

ip_addressstringrequired

registration_ip_addressstring | nullrequired

can_grant_adminbooleanrequired

can_revoke_adminbooleanrequired

can_grant_moderationbooleanrequired

can_revoke_moderationbooleanrequired

can_impersonatebooleanrequired

like_countintegerrequired

like_given_countintegerrequired

topic_countintegerrequired

flags_given_countintegerrequired

flags_received_countintegerrequired

private_topics_countintegerrequired

can_delete_all_postsbooleanrequired

can_be_deletedboolean

can_be_anonymizedbooleanrequired

can_be_mergedbooleanrequired

full_suspend_reasonstring | nullrequired

latest_exportobject | null

full_silence_reasonstring | null

silence_reasonstring | null

post_edits_countinteger | null

primary_group_idinteger | nullrequired

badge_countintegerrequired

warnings_received_countintegerrequired

bounce_scoreinteger | nullrequired

reset_bounce_score_afterstring | nullrequired

can_view_action_logsbooleanrequired

can_disable_second_factorbooleanrequired

can_delete_sso_recordbooleanrequired

api_key_countintegerrequired

similar_users_countinteger

single_sign_on_recordstring | nullrequired

approved_byobject | nullrequired

Show child attributes

idintegerrequired

usernamestringrequired

namestringrequired

avatar_templatestringrequired

suspended_bystring | nullrequired

silenced_bystring | nullrequired

penalty_countsobject

Show child attributes

silencedintegerrequired

suspendedintegerrequired

next_penaltystring

tl3_requirementsobject

Show child attributes

time_periodintegerrequired

requirements_metbooleanrequired

requirements_lostbooleanrequired

trust_level_lockedbooleanrequired

on_grace_periodbooleanrequired

days_visitedintegerrequired

min_days_visitedintegerrequired

num_topics_replied_tointegerrequired

min_topics_replied_tointegerrequired

topics_viewedintegerrequired

min_topics_viewedintegerrequired

posts_readintegerrequired

min_posts_readintegerrequired

topics_viewed_all_timeintegerrequired

min_topics_viewed_all_timeintegerrequired

posts_read_all_timeintegerrequired

min_posts_read_all_timeintegerrequired

num_flagged_postsintegerrequired

max_flagged_postsintegerrequired

num_flagged_by_usersintegerrequired

max_flagged_by_usersintegerrequired

num_likes_givenintegerrequired

min_likes_givenintegerrequired

num_likes_receivedintegerrequired

min_likes_receivedintegerrequired

num_likes_received_daysintegerrequired

min_likes_received_daysintegerrequired

num_likes_received_usersintegerrequired

min_likes_received_usersintegerrequired

penalty_countsobjectrequired

Show child attributes

silencedintegerrequired

suspendedintegerrequired

totalintegerrequired

groupsArray<object>required

Show child attributes

idintegerrequired

automaticbooleanrequired

namestringrequired

display_namestringrequired

user_countintegerrequired

mentionable_levelintegerrequired

messageable_levelintegerrequired

visibility_levelintegerrequired

primary_groupbooleanrequired

titlestring | nullrequired

grant_trust_levelstring | nullrequired

incoming_emailstring | nullrequired

has_messagesbooleanrequired

flair_urlstring | nullrequired

flair_bg_colorstring | nullrequired

flair_colorstring | nullrequired

flair_group_idinteger | null

bio_rawstring | nullrequired

bio_cookedstring | nullrequired

bio_excerptstring | nullrequired

public_admissionbooleanrequired

public_exitbooleanrequired

allow_membership_requestsbooleanrequired

full_namestring | nullrequired

default_notification_levelintegerrequired

membership_request_templatestring | nullrequired

members_visibility_levelintegerrequired

can_see_membersbooleanrequired

can_admin_groupbooleanrequired

publish_read_statebooleanrequired

external_idsobjectrequired

include_ipbooleanrequired

upcoming_changes_statsArray<object>

Show child attributes

namestringrequired

humanized_namestringrequired

descriptionstringrequired

enabledbooleanrequired

specific_groupsArray<string>required

reasonstringenabled_for_everyoneenabled_for_no_onein_specific_groupsnot_in_specific_groupsrequired

Docs by Sourcey