Search Host Assets

Search for assets in the Global IT Asset Inventory that satisfy the specified filter criteria, including hardware, software, tags, and agent information.

Note: The Qualys API enforces rate limits. For more information, refer to Qualys documentation.

External Documentation

To learn more, visit the Qualys Global IT Asset Inventory documentation.

​

Parameters

Parameter	Description
Exclude Fields	Select the fields to exclude from the response. All other fields are returned normally.
Filter	The Qualys QQL query used to filter the assets. For Example: netbiosName: 'acme' AND assetName: 'acme.qualys.com' or operatingSystem.category1:Linux.
Include Fields	Select the fields to include in the response. All other fields are returned with a null value.
Last Modified Date	The date used to return only assets modified on or after this date.
Last Seen Asset ID	The asset ID used to return only assets with an ID greater than this value.
Page Size	The maximum number of assets to return per page. The maximum value is 100.

​

Example Output

{
	"responseMessage": "Valid API Access",
	"count": 1,
	"responseCode": "SUCCESS",
	"lastSeenAssetId": 10685701,
	"hasMore": 1,
	"assetListData": {
		"asset": [
			{
				"assetId": 10685701,
				"assetUUID": "c146d7e5-2d1d-4201-b654-0990d09e357b",
				"hostId": 2289420,
				"lastModifiedDate": "2019-08-01T21:53:16.048Z",
				"agentId": "c146d7e5-2d1d-4201-b654-0990d09e357b",
				"assetType": "HOST",
				"address": "10.90.2.249",
				"dnsName": null,
				"assetName": "Amy-POD4-Agent-quays_iz72-Centos7+mysql",
				"netbiosName": null,
				"operatingSystem": {
					"osName": "CentOS Linux 7.6.1810",
					"fullName": "CentOS 7",
					"category1": "Linux",
					"category2": "Server"
				},
				"openPortListData": {
					"openPort": [
						{
							"port": 22,
							"protocol": "TCP",
							"detectedService": "An open source SSH server daemon"
						}
					]
				},
				"softwareListData": {
					"software": [
						{
							"fullName": "OpenBSD OpenSSH 7 7.4 (7.4p1)",
							"productName": "OpenSSH",
							"publisher": "OpenBSD",
							"version": "7.4"
						}
					]
				},
				"provider": "AWS",
				"cloudProvider": {
					"aws": {
						"ec2": {
							"instanceId": "i-087965612d096c93d",
							"instanceState": "RUNNING",
							"instanceType": "t2.micro",
							"publicIpAddress": "3.86.24.68",
							"region": {
								"code": "us-east-1",
								"name": "US East (N. Virginia)"
							}
						}
					}
				},
				"agent": {
					"version": "2.4.0.75",
					"lastCheckedIn": 1564695367151,
					"lastInventory": 1564695367000
				},
				"tagList": {
					"tag": [
						{
							"tagId": 104776729,
							"tagName": "Cloud Agent",
							"businessImpact": "LOW"
						}
					]
				},
				"serviceList": {
					"service": [
						{
							"name": "auditd.service",
							"status": "loaded/active/running"
						}
					]
				}
			}
		]
	}
}