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

Return a list of devices in an Iru Endpoint Management tenant.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Iru Endpoint Management documentation](https://api-docs.iru.com/#78209960-31a7-4e3b-a2c0-95c7e65bb5f9).

## Parameters

| Parameter | Description |
| - | - |
| Device ID | Search for a specific device by ID. |
| Limit | If not specified, the default limit is 300 |
| Offset | Specify the starting record to return. |
| Platform | Return all records matching a specific platform. |
| Serial Number | Search for a specific device by Serial Number. If partial serial number is provided in the query, all device containing the partial string will be returned. |
| User Email Exact Match | Return results "matching" the specified email address. |
| User Email Partial Match | Return results "containing" search on email address. |

## Example Output

```json theme={"dark"}
[
	{
		"device_id": "03f81208-2b6a-4a77-81f5-cf1633bcfb95",
		"device_name": "accuhive's MacBook Air",
		"model": "MacBook Air (M1, 2020)",
		"serial_number": "FVHHFKF7Q6L4",
		"platform": "Mac",
		"os_version": "14.4.1",
		"supplemental_build_version": "23E224",
		"supplemental_os_version_extra": "",
		"last_check_in": "2024-07-23T14:11:37.150080Z",
		"user": {
			"email": "accuhive.admin@kandji.io",
			"name": "acchuive admin",
			"id": "5344c996-8823-4b37-8d6e-8515fc7c3a0a",
			"is_archived": false,
			"active": false
		},
		"asset_tag": "sending_tag_to_now",
		"blueprint_id": "ab102b9d-8e9c-420d-a498-f2a1123091c7",
		"mdm_enabled": true,
		"agent_installed": true,
		"is_missing": false,
		"is_removed": false,
		"agent_version": "4.5.9 (5160)",
		"first_enrollment": "2024-01-26 16:15:36.087016+00:00",
		"last_enrollment": "2024-05-13 20:09:27.374451+00:00",
		"blueprint_name": "main hive",
		"lost_mode_status": "",
		"tags": [
			"accuhive_02"
		]
	},
	{
		"device_id": "d6ac2d8c-3852-4dc1-afe7-d5a32306ee39",
		"device_name": "14_1_1_23B81_as_adcs_testing",
		"model": "Virtual Machine",
		"serial_number": "Z6V0YW4M1C",
		"platform": "Mac",
		"os_version": "14.1.1",
		"supplemental_build_version": "23B81",
		"supplemental_os_version_extra": "",
		"last_check_in": "2023-12-24T22:00:00.756187Z",
		"user": {
			"email": "accuhive.admin@kandji.io",
			"name": "acchuive admin",
			"id": "5344c996-8823-4b37-8d6e-8515fc7c3a0a",
			"is_archived": false
		},
		"asset_tag": "",
		"blueprint_id": "9b1ce867-83dd-46bb-b79a-ba2b5c3a4acc",
		"mdm_enabled": true,
		"agent_installed": true,
		"is_missing": true,
		"is_removed": false,
		"agent_version": "4.3.3 (4811)",
		"first_enrollment": "2023-11-30 16:44:13.890383+00:00",
		"last_enrollment": "2023-11-30 16:44:13.890383+00:00",
		"blueprint_name": "_testing_something",
		"lost_mode_status": "",
		"tags": []
	}
]
```

## Workflow Library Example

[List Apps on All Tenant Devices with Kandji](https://library.blinkops.com/workflows/list-apps-on-all-tenant-devices-with-kandji)

![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-apps-on-all-tenant-devices-with-kandji/canvas](https://library.blinkops.com/workflows/list-apps-on-all-tenant-devices-with-kandji/canvas)


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