> ## 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 Device Users

Retrieve a list of all device users, either for a single device or for all devices.

Returned as `DeviceUsers` objects.

**Note**: This action only supports service account connections.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Google Cloud Identity documentation](https://cloud.google.com/identity/docs/reference/rest/v1beta1/devices.deviceUsers/list).

## Basic Parameters

| Parameter | Description |
| - | - |
| Customer | The resource name of the customer, formatted as: `customers/{customer}`. `Note`: Use `customers/my_customer` if you're managing your own organization's devices. Otherwise, use `customers/{customer}`, where `{customer}` is the customer who owns the device. |
| Filter | Optional filters applied when retrieving a list of device users, formatted as: `field:value`. Separate multiple search fields by the `space` character. For example: `apps:com.android.mms brand:google default_language:English` For a list of search fields, please refer to [Google's Documentation](https://developers.google.com/workspace/admin/directory/v1/search-operators). |
| Parent Device | The device of which to search for users. To list all **DeviceUsers**, set this to `devices/-`.  To list all **DeviceUsers** owned by a device, set this to the resource name of the device, formatted as: `devices/{device}`. |
| Return All Pages | Automatically fetch all resources, page by page. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| Delegated User Override | Perform the action on behalf of another user, overriding the delegated user defined in the connection. If not specified, the delegated user is the one provided in the connection. Has no effect when using an OAuth connection. NOTE: the connection details are not edited by this input. |
| Page Size | The maximum number of objects to retrieve in a single execution. |
| Page Token | A page token, received from a previous `List Device Users` execution. Provide this to retrieve the subsequent page. When paginating, all other parameters provided must match the execution that provided the page token. |

## Example Output

```json theme={"dark"}
{
  "deviceUsers": [
    {
      "name": string,
      "userEmail": string,
      "managementState": enum (ManagementState),
      "firstSyncTime": string,
      "lastSyncTime": string,
      "userAgent": string,
      "languageCode": string,
      "compromisedState": enum (CompromisedState),
      "passwordState": enum (PasswordState),
      "createTime": string
    }
  ],
  "nextPageToken": string
}
```

## Workflow Library Example

[List Device Users with Google Cloud Identity and Send Results Via Email](https://library.blinkops.com/workflows/list-device-users-with-google-cloud-identity-and-send-results-via-email)

![Workflow Library](https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max\&auto=format\&n=ojHYuDeYX5FWuN8a\&q=85\&s=b8af968e71438a9499c3223c9bd29fb2)

Preview this Workflow on desktop

[https://library.blinkops.com/workflows/list-device-users-with-google-cloud-identity-and-send-results-via-email/canvas](https://library.blinkops.com/workflows/list-device-users-with-google-cloud-identity-and-send-results-via-email/canvas)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.