List Devices - BlinkOps Documentation

Get a list of devices.

External DocumentationTo learn more, visit the Sevco documentation.

Basic Parameters

Parameter	Description
Metadata	The metadata to filter by.
Query	A JSON object defining the query to filter the results by. For example: `{ “rules”: [ { “operator”: “exists”, “field”: “org_ui”, “value”: “example” }, { “operator”: “exists”, “field”: “hostnames”, “value”: “example” } ], “combinator”: “and” }` For more information, please refer to Sevco’s documentation.
Return All Pages	Automatically fetch all resources, page by page.
Sort	An array of sorting criteria objects. `[ { “field”: “last_observed_timestamp”, “direction”: “asc” }, { “field”: “last_activity_time”, “direction”: “desc” } ]` For more information, please refer to Sevco’s documentation.

Advanced Parameters

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.

Example Output

{
	"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
	}
}