> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Users

Return a list of users in a OneLogin account. This call returns up to 50 users per page.

<Note>
  External Documentation

  To learn more, visit the [OneLogin documentation](https://developers.onelogin.com/api-docs/2/users/list-users).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                              |
  | ---------------- | ------------------------------------------------------------------------ |
  | Email            | The email to filter by.                                                  |
  | First Name       | The first name to filter by.                                             |
  | Last Name        | The last name to filter by.                                              |
  | Page             | The page number to get results from. The value must be greater than `0`. |
  | Per Page         | The maximum number of items to return per page. Valid range is `1`-`50`. |
  | Return All Pages | Automatically fetch all resources, page by page.                         |
  | Username         | The username to filter by.                                               |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter        | Description                                                         |
  | ---------------- | ------------------------------------------------------------------- |
  | AD Login Name    | The AD login name of the user to filter results by.                 |
  | App ID           | The ID of an OneLogin application.                                  |
  | Created Since    | Returns all users created after a given date & time.                |
  | Created Until    | Returns all users created before a given date & time.               |
  | Directory ID     | The ID of the directory to filter results by.                       |
  | External ID      | The external ID to filter by.                                       |
  | Fields           | A comma separated list or a json list of user attributes to return. |
  | Last Login Since | Returns all users that logged in after a given date & time.         |
  | Last Login Until | Returns all users that logged in before a given date & time.        |
  | Updated Since    | Returns all users updated after a given date & time.                |
  | Updated Until    | Returns all users updated before a given date & time.               |
  | User IDs         | A comma separated list of the User IDs to filter results by.        |
</div>

## Example Output

```json theme={"dark"}
[
	{
		"activated_at": null,
		"distinguished_name": null,
		"external_id": null,
		"firstname": "Mike",
		"last_login": null,
		"lastname": "Tester",
		"directory_id": null,
		"invitation_sent_at": null,
		"member_of": null,
		"updated_at": "2019-08-22T18:43:55.188Z",
		"created_at": "2019-08-22T18:43:55.188Z",
		"id": 56781966,
		"invalid_login_attempts": 0,
		"locked_until": null,
		"username": null,
		"email": "mike.tester@onelogin.com",
		"phone": null,
		"state": 1,
		"group_id": null,
		"password_changed_at": "2019-08-22T18:43:55.172Z",
		"status": 1,
		"samaccountname": null
	}
]
```

## Workflow Library Example

[List Users with Onelogin and Send Results Via Email](https://library.blinkops.com/workflows/list-users-with-onelogin-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-users-with-onelogin-and-send-results-via-email/canvas" />
</div>