List Assets

Get a list of assets.

​

Basic Parameters

Parameter	Description
Additional Parameters	Additional parameters to filter by. For more information about the optional filtering parameters please refer to Claroty CTD API Documentation - Get Assets.
Format	The format of returned results.
ID	The exact ID of the asset to return.
Ipv4	The exact IPV4 of the asset to return.
Page	The page number to show results from, defaults to 1.
Per Page	The maximum number of results to return, defaults to 20.
Site ID	The exact site ID of the asset to return.

​

Advanced Parameters

Parameter	Description
Display Name Contains	A string that is contained in the name of the asset.
Ipv6	The exact IPV6 of the asset to return.
Last Seen	The exact timestamp when the device was seen in the network. Note: Should be in the next format - 2006-01-02T15:04:05 .
Last Updated	The latest change that was done to the asset.
Model Contains	A 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"
				}
			]
		}
	]
}