List Host Assets

List details for all assets in the Global IT Asset Inventory, 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.
Include Fields	Select the fields to include in the response. All other fields are returned with a null value. Select tag and agent to include tag and Cloud Agent details in the response.
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": 100,
	"responseCode": "SUCCESS",
	"lastSeenAssetId": 10677327,
	"hasMore": 1,
	"assetListData": {
		"asset": [
			{
				"assetId": 10676044,
				"assetUUID": "9da5e990-f09d-4603-8f66-734645dbc10d",
				"hostId": 2288228,
				"lastModifiedDate": "2019-07-30T07:06:34.507Z",
				"agentId": null,
				"assetType": "HOST",
				"address": "10.10.10.77",
				"dnsName": null,
				"assetName": "com2k12dc.compliance2.vuln.qa.qualys.com",
				"netbiosName": "COM2K12DC",
				"operatingSystem": {
					"osName": "Windows Server 2012 Datacenter 64 bit Edition AD",
					"fullName": "Windows Server 2012 2012 Datacenter 64-Bit",
					"category1": "Windows",
					"category2": "Server"
				},
				"openPortListData": {
					"openPort": [
						{
							"port": 389,
							"protocol": "TCP",
							"detectedService": "ldap"
						}
					]
				},
				"softwareListData": {
					"software": [
						{
							"fullName": "Microsoft Internet Explorer 10 10.0 (10.0.9200.16384)",
							"productName": "Internet Explorer",
							"publisher": "Microsoft",
							"version": "10.0"
						}
					]
				},
				"provider": "",
				"cloudProvider": {
					"aws": null,
					"azure": null,
					"gcp": null
				},
				"agent": {
					"version": null,
					"lastCheckedIn": 0,
					"lastInventory": 0
				},
				"sensor": {
					"activatedForModules": [
						"PC",
						"VM"
					],
					"lastFullScan": 1564008771000
				},
				"tagList": {
					"tag": [
						{
							"tagId": 104776583,
							"tagName": "AG1",
							"businessImpact": "HIGH"
						}
					]
				},
				"serviceList": {
					"service": []
				}
			}
		]
	}
}