> ## 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 Devices

Returns information about user devices protected using Druva inSync.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Druva documentation](https://developer.druva.com/reference/get_endpoints-v2-devices).

## Basic Parameters

| Parameter | Description |
| - | - |
| Device IDs | Filter the list of devices by specifying only the required device IDs, separated by commas. Can be obtained using the `List Devices` action. |
| Profile IDs | Specify the profile IDs, separated by commas, to get a list of devices associated with multiple profiles. Can be obtained by using the `List Profiles` action. |
| User ID | Specify the user ID to get a list of devices associated with a single user. |
| User IDs | Specify the user IDs, separated by commas, to get a list of devices associated with multiple users. Can be obtained using the `List Users` action. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| Client Version | Filter the list of devices by the inSync Client version installed on it. |
| Device Marked Inactive | Filter the list of devices that are marked as inactive. |
| Device Status | Filter the list by specifying the status of the device. |
| Max Added On | Filter to list devices that are added to Druva inSync after a particular date. |
| Max Last Connected | Filter to list devices that are connected to Druva inSync before a particular date. |
| Min Added On | Filter to list devices that are added to Druva inSync after a particular date. |
| Min Last Connected | Filter to list devices that are connected to Druva inSync after a particular date. |
| Page Token | The token to access the next page of results. Use the token value received in the previous response's parameter 'nextPageToken'. |
| Platform OS | Filter the list of devices by specifying the operating system of the device. |
| Search Prefix Device Name | Specify the prefix from the device name by which you intend to search and list the devices. |
| Serial Number | Get device information using the unique serial number assigned to an individual piece of hardware by the manufacturer. |
| Upgrade State | The upgrade state of the device. |
| Uuid | Get device information using the unique 128-bit number UUID used to identify device on internet. |

## Example Output

```json theme={"dark"}
{
	"totalSize": 1,
	"nextPageToken": "MTExMQ==",
	"devices": [
		{
			"deviceID": 12345,
			"deviceName": "Ernie Carter's Macbook",
			"serialNumber": "PX045",
			"deviceOS": "mojave",
			"deviceOSVersion": "10.14 r34567",
			"platformOS": "darwin",
			"uuid": "TY5h67-5674r-675645",
			"clientVersion": "6.1.0 r56746",
			"deviceStatus": "enabled",
			"upgradeState": "NOT UPGRADABLE",
			"userID": 1,
			"totalBackupData": "40.05 GB",
			"totalBackupDataInBytes": 43003360051,
			"addedOn": "2019-10-25T00:00:00Z",
			"lastUpgradedOn": "2019-10-25T00:00:00Z",
			"lastConnected": "2019-10-25T00:00:00Z",
			"deviceMarkedInactive": true,
			"disabledMode": "Manual",
			"disabledOn": "2019-10-25T00:00:00Z"
		}
	]
}
```