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

# Search Devices

Search for devices based on searching criteria.

The following permissions are required to run this action:

* `Devices > Read`

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                   |
  | ---------------- | ------------------------------------------------------------- |
  | Device ID        | The ID of the Armis device to search for.                     |
  | Fields           | A comma-separated list of fields to include in the response.  |
  | IP Address       | The IPv4 or IPv6 address of the devices to search for.        |
  | MAC Address      | The MAC address of the devices to search for.                 |
  | Page Size        | The maximum number of results to return per request.          |
  | Return All Pages | Automatically fetch all resources, page by page.              |
  | Search           | A query string to search records by.                          |
  | Starting Index   | The index of the first result to return, used for pagination. |
  | Tag              | The tag of the devices to search for.                         |
</div>

## Example Output

```json theme={"dark"}
{
	"data": {
		"count": 1,
		"data": [
			{
				"accessSwitch": null,
				"boundaries": "test1, tag_boundary, test2",
				"businessImpact": "Unassigned",
				"category": "Handhelds",
				"customProperties": {},
				"dataSources": [
					{
						"firstSeen": "2022-09-05T12:48:41.074628+00:00",
						"lastSeen": "2023-10-19T07:31:14+00:00",
						"name": "API",
						"types": [
							"Data Upload"
						]
					},
					{
						"firstSeen": "2021-07-04T06:40:35.166307+00:00",
						"lastSeen": "2023-10-19T07:31:14+00:00",
						"name": "Armis Smart Scanner",
						"types": [
							"Vulnerability Management"
						]
					}
				],
				"firstSeen": "2021-03-25T09:27:29.286706+00:00",
				"id": 1,
				"ipAddress": "10.202.0.122, 1.1.1.1",
				"ipv6": [
					"fe80:3::1ff:fe23:4567:890a",
					"2600:4040:f015:e900:5160:5160:4f0:acd2:1ac7"
				],
				"lastSeen": "2023-10-19T07:31:14+00:00",
				"macAddress": "00:0C:29:6D:36:75, AA:AA:AA:AA:AA:AA",
				"manufacturer": "Apple",
				"model": "iPhone 6S",
				"name": "mike's iphone",
				"names": "mike's iphone,333,222,111",
				"operatingSystem": "iOS",
				"operatingSystemVersion": "10.3.1",
				"purdueLevel": 4,
				"riskLevel": 10,
				"sensor": {
					"name": "API",
					"type": "API"
				},
				"site": {
					"location": "Ney York, yefet 16",
					"name": "New York"
				},
				"tags": [
					"ip connection online 151",
					"tag activity offline",
					"tag ip connection online",
					"66666"
				],
				"type": "Mobile Phones",
				"userIds": [
					67581
				],
				"visibility": "Full"
			}
		],
		"next": null,
		"prev": null,
		"total": 1
	},
	"success": true
}
```

## Workflow Library Example

[Search Devices with Armis Centrix and Send Results Via Email](https://library.blinkops.com/workflows/search-devices-with-armis-centrix-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/search-devices-with-armis-centrix-and-send-results-via-email/canvas" />
</div>