---
title: "GET /users.info"
method: GET
path: "/users.info"
tags: ["users"]
---

# GET /users.info

`GET /users.info`

Gets information about a user.

## Query parameters

- `token` string, required
- `include_locale` boolean
- `user` string

## Response `200`

Typical success response

- object — Schema for successful response from users.info method
  - `ok` true, required
  - `user` union[], required
    - union
      - object — user object for non enterprise type
        - `color` string
        - `deleted` boolean
        - `enterprise_user` ObjsEnterpriseUser
          - `enterprise_id` string, required
          - `enterprise_name` string, required
          - `id` string, required
          - `is_admin` boolean, required
          - `is_owner` boolean, required
          - `teams` DefsTeam[], required
        - `has_2fa` boolean
        - `id` string, required
        - `is_admin` boolean
        - `is_app_user` boolean, required
        - `is_bot` boolean, required
        - `is_external` boolean
        - `is_forgotten` boolean
        - `is_invited_user` boolean
        - `is_owner` boolean
        - `is_primary_owner` boolean
        - `is_restricted` boolean
        - `is_stranger` boolean
        - `is_ultra_restricted` boolean
        - `locale` string
        - `name` string, required
        - `presence` string
        - `profile` ObjsUserProfile, required
          - `always_active` boolean
          - `api_app_id` string
          - `avatar_hash` string, required
          - `bot_id` string
          - `display_name` string, required
          - `display_name_normalized` string, required
          - `email` string, email, nullable
          - `fields` union, required
            - object
            - object[]
              - …
          - `first_name` string, nullable
          - `guest_expiration_ts` integer, nullable
          - `guest_invited_by` string, nullable
          - `image_1024` string, uri, nullable
          - `image_192` string, uri, nullable
          - `image_24` string, uri, nullable
          - `image_32` string, uri, nullable
          - `image_48` string, uri, nullable
          - `image_512` string, uri, nullable
          - `image_72` string, uri, nullable
          - `image_original` string, uri, nullable
          - `is_app_user` boolean
          - `is_custom_image` boolean
          - `is_restricted` boolean, nullable
          - `is_ultra_restricted` boolean, nullable
          - `last_avatar_image_hash` string
          - `last_name` string, nullable
          - `memberships_count` integer
          - `name` string, nullable
          - `phone` string, required
          - `pronouns` string
          - `real_name` string, required
          - `real_name_normalized` string, required
          - `skype` string, required
          - `status_default_emoji` string
          - `status_default_text` string
          - `status_default_text_canonical` string, nullable
          - `status_emoji` string, required
          - `status_expiration` integer
          - `status_text` string, required
          - `status_text_canonical` string, nullable
          - `team` string
          - `title` string, required
          - `updated` integer
          - `user_id` string
          - `username` string, nullable
        - `real_name` string
        - `team` string
        - `team_id` string
        - `team_profile` object
          - `fields` ObjsTeamProfileField[], required
            - `field_name` string, nullable
            - `hint` string, required
            - `id` string, required
            - `is_hidden` boolean
            - `label` string, required
            - `options` union[]
              - …
            - `ordering` number, required
            - `possible_values` string[], nullable
            - `type` 'text' | 'date' | 'link' | 'mailto' | 'options_list' | 'user', required
        - `two_factor_type` string
        - `tz` union[]
          - union
            - unknown
            - string
        - `tz_label` string
        - `tz_offset` number
        - `updated` number, required
      - object — enterprise user
        - `color` string — refercing to bug: https://jira.tinyspeck.com/browse/EVALUE-1559
        - `deleted` boolean
        - `enterprise_user` ObjsEnterpriseUser
          - `enterprise_id` string, required
          - `enterprise_name` string, required
          - `id` string, required
          - `is_admin` boolean, required
          - `is_owner` boolean, required
          - `teams` DefsTeam[], required
        - `has_2fa` boolean
        - `id` string, required
        - `is_admin` boolean
        - `is_app_user` boolean, required
        - `is_bot` boolean, required
        - `is_external` boolean
        - `is_forgotten` boolean
        - `is_owner` boolean
        - `is_primary_owner` boolean
        - `is_restricted` boolean
        - `is_stranger` boolean
        - `is_ultra_restricted` boolean
        - `locale` string
        - `name` string, required
        - `presence` string
        - `profile` ObjsUserProfile, required
          - `always_active` boolean
          - `api_app_id` string
          - `avatar_hash` string, required
          - `bot_id` string
          - `display_name` string, required
          - `display_name_normalized` string, required
          - `email` string, email, nullable
          - `fields` union, required
            - object
            - object[]
              - …
          - `first_name` string, nullable
          - `guest_expiration_ts` integer, nullable
          - `guest_invited_by` string, nullable
          - `image_1024` string, uri, nullable
          - `image_192` string, uri, nullable
          - `image_24` string, uri, nullable
          - `image_32` string, uri, nullable
          - `image_48` string, uri, nullable
          - `image_512` string, uri, nullable
          - `image_72` string, uri, nullable
          - `image_original` string, uri, nullable
          - `is_app_user` boolean
          - `is_custom_image` boolean
          - `is_restricted` boolean, nullable
          - `is_ultra_restricted` boolean, nullable
          - `last_avatar_image_hash` string
          - `last_name` string, nullable
          - `memberships_count` integer
          - `name` string, nullable
          - `phone` string, required
          - `pronouns` string
          - `real_name` string, required
          - `real_name_normalized` string, required
          - `skype` string, required
          - `status_default_emoji` string
          - `status_default_text` string
          - `status_default_text_canonical` string, nullable
          - `status_emoji` string, required
          - `status_expiration` integer
          - `status_text` string, required
          - `status_text_canonical` string, nullable
          - `team` string
          - `title` string, required
          - `updated` integer
          - `user_id` string
          - `username` string, nullable
        - `real_name` string
        - `team_id` string
        - `team_profile` object
          - `fields` ObjsTeamProfileField[], required
            - `field_name` string, nullable
            - `hint` string, required
            - `id` string, required
            - `is_hidden` boolean
            - `label` string, required
            - `options` union[]
              - …
            - `ordering` number, required
            - `possible_values` string[], nullable
            - `type` 'text' | 'date' | 'link' | 'mailto' | 'options_list' | 'user', required
        - `teams` DefsWorkspaceId[]
        - `two_factor_type` string
        - `tz` union[]
          - union
            - unknown
            - string
        - `tz_label` string
        - `tz_offset` number
        - `updated` number, required

## Other responses

- `default` — Typical error response

---

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