# List users in the account

Launch stage: Beta

`GET /api/2.0/identity/users`

Lists the users in the Databricks account that parents the
 calling workspace, returning one page per call. Supports filtering by username or external ID.

API scopes: identity

## Query parameters

- `page_size` (int32, optional)
  The maximum number of users to return. The service may return fewer than this value.
   If not provided, defaults to 1000, which is also the maximum allowed. Requests for more than the maximum are clamped to 1000.
- `page_token` (string, optional)
  A page token, received from a previous ListUsers call. Provide this to retrieve the subsequent page.
- `filter` (string, optional)
  Optional. Allows filtering users by username or external id.

## Returns

Returns a list of User objects.

## Response

```json
{
  "users": [
    {
      "account_id": "string",
      "user_id": "string",
      "external_id": "string",
      "username": "string",
      "full_name": {},
      "account_user_status": "ACTIVE"
    }
  ],
  "next_page_token": "string"
}
```