Sample - Slack Web API
GET/users.info

Get user information

Retrieves information about a specified user or, when user is omitted, the user associated with the authentication context. Set include_locale to include the user's locale in the returned user object.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 parameters
tokenstringrequired
Authentication token with the `users:read` scope.
include_localebooleanoptional
Whether to include the user's locale; defaults to false when omitted.
userstringoptional
User ID whose information to retrieve.

2 status codes
200Returns the requested `user` object, including locale information when `include_locale` is true.
okbooleanrequired
Allowed:true
userarrayrequired
defaultTypical error response
callstackstringoptional
errorstringrequired
Allowed:user_not_founduser_not_visiblenot_authedinvalid_authaccount_inactiveinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_typemissing_post_typeteam_added_to_org
okbooleanrequired
Allowed:false

Error handling

An authentication token with the users:read scope is required. include_locale must be a boolean when provided and defaults to false, while user identifies the user whose information to retrieve.