List users

GET {{baseUrl}}/users?status=active&page_size=30&role_id=<string>&page_number=<string>&include_fields=host_key&next_page_token=<string>&license=zoom_workforce_management

Retrieve a list your account's users.

Scopes: user:read:admin

Rate Limit Label : MEDIUM

Request Params

| Key | Datatype | Required | Description | | status | string | | The user's status.

  • active - The user exists on the account.
  • inactive - The user has been deactivated.
  • pending - The user exists on the account, but has not activated their account. See Managing users for details.

This value defaults to active. | | page_size | number | | The number of records returned within a single API call. | | role_id | string | | The role's unique ID. Use this parameter to filter the response by a specific role. You can use the List roles API to get a role's unique ID value. | | page_number | string | | The page number of the current page in the returned records. | | include_fields | string | | Use this parameter to display one of the following attributes in the API call's response:

  • custom_attributes &mdash; Return the user's custom attributes.
  • host_key &mdash; Return the user's host key. | | next_page_token | string | | Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes. | | license | string | | The user's license. Filter the response by a specific license. |

HEADERS

| Key | Datatype | Required | Description | | Accept | string | | |

RESPONSES

status: OK

{&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;page_number&quot;:1,&quot;page_size&quot;:30,&quot;total_records&quot;:&quot;\u003cinteger\u003e&quot;,&quot;users&quot;:[{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;type&quot;:2,&quot;user_created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;custom_attributes&quot;:[{&quot;key&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;key&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;dept&quot;:&quot;\u003cstring\u003e&quot;,&quot;employee_unique_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;first_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;group_ids&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;host_key&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;im_group_ids&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;last_client_version&quot;:&quot;\u003cstring\u003e&quot;,&quot;last_login_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;last_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;plan_united_type&quot;:&quot;128&quot;,&quot;pmi&quot;:&quot;\u003clong\u003e&quot;,&quot;role_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;inactive&quot;,&quot;timezone&quot;:&quot;\u003cstring\u003e&quot;,&quot;verified&quot;:1,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;type&quot;:1,&quot;user_created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;created_at&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;custom_attributes&quot;:[{&quot;key&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;},{&quot;key&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;}],&quot;dept&quot;:&quot;\u003cstring\u003e&quot;,&quot;employee_unique_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;first_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;group_ids&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;host_key&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;im_group_ids&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;last_client_version&quot;:&quot;\u003cstring\u003e&quot;,&quot;last_login_time&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;last_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;plan_united_type&quot;:&quot;256&quot;,&quot;pmi&quot;:&quot;\u003clong\u003e&quot;,&quot;role_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;active&quot;,&quot;timezone&quot;:&quot;\u003cstring\u003e&quot;,&quot;verified&quot;:1,&quot;display_name&quot;:&quot;\u003cstring\u003e&quot;}]}