GET/organization/users

List organization users

Lists users in the organization. Use emails to filter the list by email address and limit and after to control the page of results. The response includes pagination fields to help you retrieve additional users.

3 parameters
limitintegeroptional
Maximum number of users to return, from 1 to 100. Defaults to 20 when omitted.
Default:20
afterstringoptional
User ID cursor that marks the position to continue listing from.
emailsarray<string>optional
Filter the results by one or more user email addresses.

4 status codes
200Returns a list of organization users with pagination fields, including `first_id`, `last_id`, and `has_more`.
objectstringrequired
Allowed:list
dataarray<object>required
first_idstringoptional
last_idstringoptional
has_morebooleanrequired
400Returned when the user listing parameters are invalid.
errorobjectrequired
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
429Returned when management requests exceed the rate limit.
errorobjectrequired

Error handling

limit must be between 1 and 100; it defaults to 20 when omitted, and invalid listing parameters return a 400. A 403 is returned when the authenticated user does not have permission to list organization users. A 429 is returned when management requests exceed the rate limit.