Get Host Asset

Get the details of a specific asset 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
Asset ID	The ID of the asset to retrieve.
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.

​

Example Output

{
	"responseMessage": "Valid API Access",
	"count": 1,
	"responseCode": "SUCCESS",
	"lastSeenAssetId": null,
	"hasMore": 0,
	"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"
						}
					]
				}
			}
		]
	}
}