Get a list of assets.

​
Basic Parameters

ParameterDescription
Additional ParametersAdditional parameters to filter by. For more information about the optional filtering parameters please refer to Claroty CTD API Documentation - Get Assets.
FormatThe format of returned results.
IDThe exact ID of the asset to return.
Ipv4The exact IPV4 of the asset to return.
PageThe page number to show results from, defaults to 1.
Per PageThe maximum number of results to return, defaults to 20.
Site IDThe exact site ID of the asset to return.

​
Advanced Parameters

ParameterDescription
Display Name ContainsA string that is contained in the name of the asset.
Ipv6The exact IPV6 of the asset to return.
Last SeenThe exact timestamp when the device was seen in the network.

Note: Should be in the next format - 2006-01-02T15:04:05 .
Last UpdatedThe latest change that was done to the asset.
Model ContainsA string that is contained in the model of the asset.

​
Example Output

{
	"count_filtered": 40,
	"count_total": 40,
	"count_in_page": 10,
	"objects": [
		{
			"resource_id": "179-1",
			"id": 179,
			"site_id": 1,
			"approved": true,
			"asset_type": 2,
			"asset_type__": "eEndpoint",
			"class_type": "IT",
			"criticality": 0,
			"criticality__": "eLow",
			"display_name": "display name",
			"first_seen": "2020-05-03T09:22:49+00:00",
			"last_seen": "2020-05-03T09:22:49+00:00",
			"last_updated": "2022-11-14T14:03:03+00:00",
			"ghost": false,
			"hostname": "display name",
			"installed_programs_count": 0,
			"mac": [
				"string"
			],
			"name": "name",
			"network_id": 1,
			"num_alerts": 1,
			"patch_count": 0,
			"parsed": false,
			"protocol": [
				"DHCPv4"
			],
			"purdue_level": 3,
			"risk_level": 0,
			"site_name": "Default",
			"special_hint": 0,
			"special_hint__": "eUnicast",
			"vlan": [
				"0"
			],
			"virtual_zone_id": 3,
			"virtual_zone_name": "Endpoint: Other",
			"vendor": "Realtek Semiconductor",
			"valid": true,
			"subnet_id": 1,
			"usb_devices_count": 0,
			"timestamp": "2020-05-03T09:22:49+00:00",
			"network": {
				"resource_id": "179-1",
				"id": 179,
				"site_id": 1,
				"name": "Default"
			},
			"active_queries_names": [
				"string"
			],
			"active_scans_names": [
				"string"
			],
			"children": [
				null
			],
			"custom_attributes": [
				null
			],
			"custom_informations": [
				null
			],
			"insight_names": [
				"string"
			],
			"code_sections": [
				{
					"type": "xml",
					"filename": "filename",
					"rid": "1-1"
				}
			]
		}
	]
}

​
Workflow Library Example

List Assets with Claroty Ctd and Send Results Via Email

Preview this Workflow on desktop