> ## 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
Get a list of devices.
External Documentation
To learn more, visit the [Device 42 documentation](https://api.device42.com/#Devices_getDevices_2).
## Basic Parameters
| Parameter | Description |
| --------- | -------------------------------------------------------------------------------- |
| Device ID | The ID of the device to get details on. |
| Fields | List of fields to return for each device in the result. |
| Limit | The maximum number of objects to return in the response. |
| Name | The name of the device to filter the results by. |
| Offset | The pagination offset indicating the starting point for the next set of results. |
## Advanced Parameters
| Parameter | Description |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| AND Tags | A comma-separated list of tags to filter by (AND related - return results that include all the tags). |
| Asset Number | An asset number of a device to filter the results by. |
| Asset Number Contains | Returns only assets whose asset number contains the specified value. |
| Blade Chassis | Filter by whether device is a blade chassis. |
| Cluster Device ID | The cluster device ID to filter by. |
| Custom Fields (AND) | A comma-separated list of custom fields to filter the results by (AND). Format - `key1:value1,key2:value2` |
| Custom Fields (OR) | A comma-separated list of custom fields to filter the results by (OR). Format - `key1:value1,key2:value2` |
| Customer | The name of the customer to filter the results by. |
| Customer ID | The customer ID of the device to filter by. |
| First Added After | Filter objects first added after or on the given date . |
| First Added Before | Filter objects first added before the given date. |
| Hardware | The hardware name of the device to filter by. |
| Hardware ID | The hardware ID of the device to filter by. |
| Host Chassis Device ID | The host chassis device ID to filter by. |
| In Service | Whether the device is in-service. |
| Last Edited After | Filter devices last edited after the given date. |
| Last Edited Before | Filter devices last edited before the given date. |
| OS ID | The ID of the operating system of the device to filter by. |
| OS Name | The operating system name of the device to filter by. |
| Object Category | The object category name of the device to filter by. |
| Object Category ID | The object category ID of the device to filter by. |
| Physical Subtype | The physical subtype name of the device to filter by. |
| Physical Subtype ID | The physical subtype ID of the device to filter by. |
| Rack ID | The rack ID of the device to filter by. |
| Serial Number | Serial number of a device to filter the results by. |
| Serial Number Contains | A part of the device serial number to filter the results by. |
| Service Level | The service level of the device to filter by. |
| Service Level ID | The ID of the service level of the device to filter by. |
| Tags | A comma-separated list of tags to filter results by (OR filter - return results that include at least one of the tags). |
| Type | The type of the device to filter by. |
| Type ID | The ID of the type of the device to filter by. |
| UUID | The unique ID to filter the results by. |
| Virtual Host | Filter by whether device is a virtual host. |
| Virtual Host Device ID | The virtual host device ID to filter by. |
| Virtual Subtype | The virtual subtype name of the device to filter by. |
| Virtual Subtype ID | The virtual subtype ID of the device to filter by. |
## Example Output
```json theme={"dark"}
{
"Devices": {
"total_count": "709",
"limit": "1",
"devices": [
{
"name": "Device_Name",
"type_id": 2,
"serial_no": "FOC1252W6EW",
"asset_no": "123456",
"device_url": "/api/2.0/devices/64/",
"device_id": "64",
"type": "physical",
"uuid": ""
}
],
"offset": "0"
}
}
```
## Workflow Library Example
[List Devices with Device 42 and Send Results Via Email](https://library.blinkops.com/workflows/list-devices-with-device-42-and-send-results-via-email)
Preview this Workflow on desktop