Lists all users in a Slack team.
| |
|---|
| Surface | web-api |
| Rate limit | Tier 2 (20/min) |
| Argument | Required | Type | |
|---|
limit | no | integer | The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn’t been reached. Providing no limit value will result in Slack attempting to deliver you the entire result set. If the collection is too large you may experience limit_required or HTTP 500 errors. |
cursor | no | string | Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request’s response_metadata. Default value fetches the first “page” of the collection. See pagination for more detail. |
include_locale | no | boolean | Set this to true to receive the locale for users. Defaults to false |
ok is always present (true, or false with error). Additional fields:
| Field | Type | |
|---|
cache_ts | integer | |
members | object[] | |
response_metadata | object | |
Works with every official Slack SDK — call it exactly as you would against Slack.
| |
|---|
| Source spec | Slack Web API OpenAPI v1.7.0 (apis.guru OAS3 conversion of slackapi/slack-api-specs, upstream archived 2024-03) |
| Retrieved / verified | 2026-06-04 · patches applied: 0 |
| In frozen spec | yes — fields below are copied from the published spec |
| Conformance | exercised by unmodified official SDKs on every release |
| See also | Slack’s users.list reference |