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

<Note>
  External Documentation

  To learn more, visit the [Sevco documentation](https://docs.sev.co/reference/getassetlistv3).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
  | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Metadata         | The metadata to filter by.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | Query            | A JSON object defining the query to filter the results by.<br /><br />For example:<br /><pre><code>\{<br />    "rules": \[<br />      \{<br />        "operator": "exists",<br />        "field": "org\_ui",<br />        "value": "example"<br />      },<br />      \{<br />        "operator": "exists",<br />        "field": "hostnames",<br />        "value": "example"<br />      }<br />    ],<br />    "combinator": "and"<br />  }</code></pre><br />For more information, please refer to [Sevco's documentation](https://docs.sev.co/reference/getassetlistv3). |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | Sort             | An array of sorting criteria objects.<br /><pre><code>\[<br />    \{<br />      "field": "last\_observed\_timestamp",<br />      "direction": "asc"<br />    },<br />    \{<br />      "field": "last\_activity\_time",<br />      "direction": "desc"<br />    }<br />]</code></pre><br />For more information, please refer to [Sevco's documentation](https://docs.sev.co/reference/getassetlistv3).                                                                                                                                                                      |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                       |
  | --------- | ------------------------------------------------- |
  | Page      | The page number to get results from.              |
  | Per Page  | The maximum number of results to return per page. |
  | Total     | The total number of devices.                      |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"id": "string",
			"last_observed_timestamp": "string",
			"last_activity_time": "string",
			"first_observed_timestamp": "string",
			"org_id": "string",
			"version": "string",
			"attributes": {
				"os": "string",
				"ips": [
					"string"
				],
				"groups": [
					null
				],
				"hostnames": [
					"string"
				],
				"os_category": "string",
				"recent_users": [
					null
				],
				"mac_addresses": [
					"string"
				],
				"mac_manufacturers": [
					"string"
				],
				"distinguished_name": "string"
			},
			"sources": [
				{
					"config_id": "string",
					"id": "string",
					"last_observed_timestamp": "string",
					"last_activity_timestamp": "string",
					"source": "string",
					"version": "string"
				}
			]
		}
	],
	"pagination": {
		"page": 0,
		"per_page": 0,
		"total": 0
	}
}
```

## Workflow Library Example

[List Devices with Sevco and Send Results Via Email](https://library.blinkops.com/workflows/list-devices-with-sevco-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-devices-with-sevco-and-send-results-via-email/canvas" />
</div>