> ## 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.
# Get Role Users
Get a list of users assigned to a role by its ID.
**Required Scope**: `Manage All`, `Read All`, or `Read Users`.
External Documentation
To learn more, visit the [OneLogin documentation](https://developers.onelogin.com/api-docs/2/roles/get-role-users).
## Parameters
| Parameter | Description |
| ------------------ | ------------------------------------------------------------------------------------ |
| Include Unassigned | Select to include users that are not currently assigned to the role. |
| Name | The name to filter by. Applies to first name, last name, username, and email fields. |
| Page | The page number to get results from. The value must be greater than `0`. |
| Per Page | The maximum number of results to return per page. |
| Return All Pages | Automatically fetch all resources, page by page. |
| Role ID | The ID of the role. |
## Example Output
```json theme={"dark"}
[
{
"id": 345,
"name": "Joe User",
"username": "joe.user@example.com",
"added_by": {
"id": 678,
"name": "Susan Boss"
},
"added_at": "2019-12-27T00:00:00Z",
"assigned": true
}
]
```
## Workflow Library Example
[Get Role Users with Onelogin and Send Results Via Email](https://library.blinkops.com/workflows/get-role-users-with-onelogin-and-send-results-via-email)
Preview this Workflow on desktop