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

# GET /users.list

`GET /users.list`

Lists all users in a Slack team.

## Query parameters

- `token` string
- `limit` integer
- `cursor` string
- `include_locale` boolean

## Response `200`

Typical success response

- object — Schema for successful response from users.list method
  - `cache_ts` integer, required
  - `members` ObjsUser[], required
    - union[]
      - 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
              - …
            - `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
              - …
          - `two_factor_type` string
          - `tz` union[]
            - union
              - …
          - `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
              - …
            - `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
              - …
          - `teams` DefsWorkspaceId[]
          - `two_factor_type` string
          - `tz` union[]
            - union
              - …
          - `tz_label` string
          - `tz_offset` number
          - `updated` number, required
  - `ok` true, required
  - `response_metadata` union[]
    - union
      - object
        - `next_cursor` string, required
      - object
        - `messages` string[], required
        - `warnings` string[], required
      - object
        - `messages` string[], required
        - `next_cursor` string, required
        - `warnings` string[], 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)