Get Host Details of Specific Asset
Get details of a specific asset by providing an asset ID.
Input ParametersInput Parameters
|
Parameter |
Mandatory /Optional |
Data Type |
Description |
|---|---|---|---|
|
excludeFields |
Optional |
string |
Comma-separated list of fields to be excluded from the asset object in the response. The default is None. You can choose from the list of fields specified in the Limit your results section. For example, to exclude openPort and software from the response: excludeFields=openPort,software |
|
includeFields |
Optional |
string |
Comma-separated list of fields to be included in the asset object in the response. The default is All. You can choose from the list of fields specified in the Limit your results section. For example, to include only operatingSystem and hardware in the response: includeFields=operatingSystem,hardware |
|
assetId |
Mandatory |
integer |
Use to specify theAssetId for which you want to retrieve the details. |
|
softwareType |
Optional |
string |
Specify the software type to get the host details for specified software type. Available values for softwareType parameter are Application, Unknown, and Others. |
|
Authorization |
Mandatory |
string |
Authorization token to authenticate to the Qualys Cloud Platform. Prepend token with "Bearer" and one space. For example - Bearer authToken |
Sample - Get Host Details of Specified Asset by assetidSample - Get Host Details of Specified Asset by assetid
API Request
curl -X GET -H "Accept: */*"
-H "Authorization: Bearer <JWTToken>"
-H "Content-Type: application/json" -i
"<qualys_base_url>/rest/2.0/get/am/asset?assetId=8194990"
Response
{
"responseMessage": "Valid API Access",
"count": 1,
"responseCode": "SUCCESS",
"lastSeenAssetId": null,
"hasMore": 0,
"assetListData": {
"asset": [
{
"assetId": 69169700,
"assetUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"hostId": "xxxxxxxxxxxxxx",
"lastModifiedDate": "2025-07-16T05:35:00.000Z",
"agentId": null,
"createdDate": "2025-07-16T05:35:00.000Z",
"sensorLastUpdatedDate": "2025-07-16T05:35:00.000Z",
"assetType": "HOST",
"address": "2600:1408....",
"dnsName": "Sample DNS name",
"assetName": "Sample asset name",
"netbiosName": "Sample",
"timeZone": "+05:30",
"biosDescription": null,
"lastBoot": "2023-06-06T11:16:39.000Z",
"totalMemory": 0,
"cpuCount": 1,
"lastLoggedOnUser": null,
"domainRole": null,
"hwUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"biosSerialNumber": "SN1235",
"biosAssetTag": "NoAssetTag",
"isContainerHost": false,
"operatingSystem": {
"osName": "EPSON 11a/b/g/n/ac & 10/100 Print Server",
"fullName": "EPSON 11a/b/g/n/ac & 10/100 Print Server",
"category": "Unidentified / Unidentified",
"category1": "Unidentified",
"category2": "Unidentified",
"productName": "Unidentified",
"publisher": "Unidentified",
"edition": null,
"marketVersion": null,
"version": null,
"update": null,
"architecture": null,
"lifecycle": {
"gaDate": null,
"eolDate": null,
"eosDate": null,
"stage": "Not Applicable",
"lifeCycleConfidence": "Exact",
"eolSupportStage": " ",
"eosSupportStage": " ",
"detectionScore": 0
},
"taxonomy": {
"id": null,
"name": "Unidentified / Unidentified",
"category1": "Unidentified",
"category2": "Unidentified"
},
"productUrl": ",,",
"productFamily": null,
"installDate": null,
"release": "",
"cpeId": null,
"cpe": null,
"cpeType": null
},
"hardware": {
"fullName": "Epson Print Server",
"category": "Networking Device / Print Server",
"category1": "Networking Device",
"category2": "Print Server",
"manufacturer": "Epson",
"productName": "Print Server",
"model": null,
"lifecycle": {
"introDate": null,
"gaDate": null,
"eosDate": null,
"obsoleteDate": null,
"stage": "Unknown",
"lifeCycleConfidence": " "
},
"taxonomy": {
"id": null,
"name": "Networking Device / Print Server",
"category1": "Networking Device",
"category2": "Print Server"
},
"productUrl": ",,",
"productFamily": null
},
"userAccountListData": {
"userAccount": []
},
"openPortListData": {
"openPort": [
{
"port": 69,
"description": "Trivial File Transfer Protocol (TFTP)",
"protocol": "TCP",
"detectedService": "TFTP (Trivial File Transfer Protocol)",
"firstFound": "2024-04-22T05:15:28.000Z",
"lastUpdated": "2024-04-22T05:15:28.000Z",
"authorization": null,
"detectionScore": null,
"discoverySources": "IP Scanner"
},
{
"port": 162,
"description": "SNMP Traps are alert messages sent from a remote SNMP-enabled device to a central collector, the \"SNMP manager\".",
"protocol": "TCP",
"detectedService": "SNMP TRAP",
"firstFound": "2024-04-22T05:15:28.000Z",
"lastUpdated": "2024-04-22T05:15:28.000Z",
"authorization": null,
"detectionScore": null,
"discoverySources": "IP Scanner"
},
{
"port": 9200,
"description": "Elasticsearch is a distributed engine for search and analytics.",
"protocol": "TCP",
"detectedService": "Elasticsearch",
"firstFound": "2024-04-22T05:15:28.000Z",
"lastUpdated": "2024-04-22T05:15:28.000Z",
"authorization": null,
"detectionScore": null,
"discoverySources": "IP Scanner"
},
{
"port": 27017,
"description": "MongoDB is a flexible, high-performance NoSQL document database.",
"protocol": "TCP",
"detectedService": "MONGODB",
"firstFound": "2024-04-22T05:15:28.000Z",
"lastUpdated": "2024-04-22T05:15:28.000Z",
"authorization": null,
"detectionScore": null,
"discoverySources": "IP Scanner"
},
{
"port": 9300,
"description": "Elasticsearch is a distributed engine for search and analytics.",
"protocol": "TCP",
"detectedService": "Elasticsearch",
"firstFound": "2024-04-22T05:15:28.000Z",
"lastUpdated": "2024-04-22T05:15:28.000Z",
"authorization": null,
"detectionScore": null,
"discoverySources": "IP Scanner"
}
]
},
"volumeListData": {
"volume": [
{
"name": "C:",
"free": 29584035840,
"size": 63814234112
}
]
},
"networkInterfaceListData": {
"networkInterface": [
{
"hostname": "UAI Test 2",
"addressIpV4": null,
"addressIpV6": "2600:1408.....",
"macAddress": "xx:xx:xx:xx:xx",
"interfaceName": "",
"dnsAddress": null,
"gatewayAddress": "",
"manufacturer": null,
"macVendorIntroDate": null,
"netmask": null,
"addresses": null
}
]
},
"softwareListData": {
"software": [
{
"id": 5707384187482443000,
"discoverySources": "IP Scanner",
"fullName": "Apache HTTP Server 1.1",
"softwareType": "Application",
"isIgnored": false,
"ignoredReason": null,
"category": "Network Application / Web Servers",
"category1": "Network Application",
"category2": "Web Servers",
"productName": "Apache HTTP Server",
"component": "Server",
"publisher": "Apache",
"edition": "Unknown",
"marketVersion": "1",
"version": "1.1",
"update": "1.1",
"architecture": null,
"installDate": null,
"installPath": null,
"lastUpdated": "2024-03-22T11:23:17.000Z",
"lastUseDate": null,
"language": null,
"formerlyKnownAs": "httpd",
"isPackage": false,
"isPackageComponent": false,
"packageName": null,
"productUrl": "https://en.wikipedia.org/wiki/Apache_HTTP_Server,,",
"lifecycle": {
"gaDate": null,
"eolDate": null,
"eosDate": null,
"stage": "EOL/EOS",
"lifeCycleConfidence": "Calculated",
"eolSupportStage": " ",
"eosSupportStage": " ",
"detectionScore": 58
},
"supportStageDesc": null,
"license": {
"category": "Open Source",
"subcategory": "Apache License 2.0 (Apache-2.0)"
},
"authorization": null,
"discoveredPublisher": null,
"discoveredName": "Apache web server",
"discoveredVersion": "1.1",
"authorizationDetectionScore": null,
"cpeId": 8897,
"cpe": "cpe:2.3:a:apache:http_server:1.1:*:*:*:*:*:*:*",
"cpeType": "NIST",
"softwareInstances": null
},
{
"id": 2076594853189920500,
"discoverySources": "IP Scanner",
"fullName": "Bare Mitt Idiot 1",
"softwareType": "Application",
"isIgnored": false,
"ignoredReason": null,
"category": "Collaboration / Other",
"category1": "Collaboration",
"category2": "Other",
"productName": "Idiot",
"component": null,
"publisher": "Bare Mitt",
"edition": null,
"marketVersion": null,
"version": "1",
"update": "1",
"architecture": null,
"installDate": null,
"installPath": null,
"lastUpdated": "2024-03-22T11:23:17.000Z",
"lastUseDate": null,
"language": null,
"formerlyKnownAs": null,
"isPackage": false,
"isPackageComponent": false,
"packageName": null,
"productUrl": "Product URL",
"lifecycle": {
"gaDate": null,
"eolDate": null,
"eosDate": null,
"stage": "Unknown",
"lifeCycleConfidence": null,
"eolSupportStage": null,
"eosSupportStage": null,
"detectionScore": null
},
"supportStageDesc": null,
"license": {
"category": "Commercial",
"subcategory": "Free"
},
"authorization": null,
"discoveredPublisher": null,
"discoveredName": "Rishabh",
"discoveredVersion": "1",
"authorizationDetectionScore": null,
"cpeId": null,
"cpe": null,
"cpeType": null,
"softwareInstances": null
},
{
"id": 6765106470312955000,
"discoverySources": "IP Scanner",
"fullName": "Python 3.9.16 64-Bit",
"softwareType": "Application",
"isIgnored": false,
"ignoredReason": null,
"category": "Application Development / Programming Languages",
"category1": "Application Development",
"category2": "Programming Languages",
"productName": "Python",
"component": null,
"publisher": "Python",
"edition": "Unknown",
"marketVersion": "3",
"version": "3.9",
"update": "3.9.16",
"architecture": "64-Bit",
"installDate": null,
"installPath": null,
"lastUpdated": "2024-03-22T11:23:17.000Z",
"lastUseDate": null,
"language": null,
"formerlyKnownAs": null,
"isPackage": false,
"isPackageComponent": false,
"packageName": null,
"productUrl": "Product URL",
"lifecycle": {
"gaDate": "2020-10-05T00:00:00.000Z",
"eolDate": "2022-05-17T00:00:00.000Z",
"eosDate": "2025-10-31T00:00:00.000Z",
"stage": "EOL",
"lifeCycleConfidence": "Exact",
"eolSupportStage": "Security",
"eosSupportStage": "End of Life",
"detectionScore": 0
},
"supportStageDesc": null,
"license": {
"category": "Open Source",
"subcategory": "Python License (Python-2.0)"
},
"authorization": null,
"discoveredPublisher": null,
"discoveredName": "python3",
"discoveredVersion": "3.9.16-1.amzn2023.0.6.x86_64",
"authorizationDetectionScore": null,
"cpeId": null,
"cpe": null,
"cpeType": "NIST",
"softwareInstances": null
},
{
"id": 3090248548558872000,
"discoverySources": "IP Scanner",
"fullName": "Apache Coyote 1.1",
"softwareType": "Application",
"isIgnored": false,
"ignoredReason": null,
"category": "Network Application / Web Servers",
"category1": "Network Application",
"category2": "Web Servers",
"productName": "Coyote",
"component": null,
"publisher": "Apache",
"edition": null,
"marketVersion": "1",
"version": "1.1",
"update": "1.1",
"architecture": null,
"installDate": null,
"installPath": null,
"lastUpdated": "2024-03-22T11:23:17.000Z",
"lastUseDate": null,
"language": null,
"formerlyKnownAs": null,
"isPackage": false,
"isPackageComponent": false,
"packageName": null,
"productUrl": ",,",
"lifecycle": {
"gaDate": null,
"eolDate": null,
"eosDate": null,
"stage": "Publicly Unavailable",
"lifeCycleConfidence": "Exact",
"eolSupportStage": " ",
"eosSupportStage": " ",
"detectionScore": 0
},
"supportStageDesc": null,
"license": {
"category": "Open Source",
"subcategory": "Apache License 2.0 (Apache-2.0)"
},
"authorization": null,
"discoveredPublisher": null,
"discoveredName": "Apache-Coyote",
"discoveredVersion": "1.1",
"authorizationDetectionScore": null,
"cpeId": null,
"cpe": null,
"cpeType": "NIST",
"softwareInstances": null
},
{
"id": 3345728451636248600,
"discoverySources": "IP Scanner",
"fullName": "Amazon Web Services Elastic Load Balancing (ELB) 2.0",
"softwareType": "Application",
"isIgnored": false,
"ignoredReason": null,
"category": "Networking / Other",
"category1": "Networking",
"category2": "Other",
"productName": "Elastic Load Balancing (ELB)",
"component": null,
"publisher": "Amazon Web Services",
"edition": null,
"marketVersion": "2",
"version": "2.0",
"update": "2.0",
"architecture": null,
"installDate": null,
"installPath": null,
"lastUpdated": "2024-03-22T11:23:17.000Z",
"lastUseDate": null,
"language": null,
"formerlyKnownAs": null,
"isPackage": false,
"isPackageComponent": false,
"packageName": null,
"productUrl": ",,",
"lifecycle": {
"gaDate": null,
"eolDate": null,
"eosDate": null,
"stage": "Publicly Unavailable",
"lifeCycleConfidence": "Exact",
"eolSupportStage": " ",
"eosSupportStage": " ",
"detectionScore": 0
},
"supportStageDesc": null,
"license": {
"category": "Commercial",
"subcategory": "Licensed or Subscription"
},
"authorization": null,
"discoveredPublisher": null,
"discoveredName": "AWS ELB",
"discoveredVersion": "2.0",
"authorizationDetectionScore": null,
"cpeId": null,
"cpe": null,
"cpeType": "NIST",
"softwareInstances": null
}
]
},
"softwareComponent": null,
"provider": null,
"cloudProvider": null,
"agent": {
"version": null,
"configurationProfile": null,
"activations": null,
"connectedFrom": null,
"lastActivity": 0,
"lastCheckedIn": 0,
"lastInventory": 0,
"udcManifestAssigned": null,
"errorStatus": null
},
"sensor": {
"activatedForModules": [
"VM"
],
"pendingActivationForModules": [],
"lastVMScan": 0,
"lastComplianceScan": 0,
"lastFullScan": 0,
"lastVmScanDateScanner": 0,
"lastVmScanDateAgent": 0,
"lastPcScanDateScanner": 0,
"lastPcScanDateAgent": 0,
"firstEasmScanDate": null,
"lastEasmScanDate": null
},
"container": {
"product": null,
"version": null,
"noOfContainers": 0,
"noOfImages": 0,
"hasSensor": null
},
"inventory": {
"source": "IP",
"created": 1752644100000,
"lastUpdated": 1752644100000
},
"inventoryListData": {
"inventory": [
{
"source": "Cloud Agent",
"created": 1733293202000,
"lastUpdated": 1750164772000
},
{
"source": "IP Scanner",
"created": 1605066009000,
"lastUpdated": 1703221422000
}
]
},
"activity": {
"source": "IP",
"lastScannedDate": 1752644100000
},
"tagList": {
"tag": [
{
"tagId": 48364993,
"tagName": "UaiTestAtsCtsTag1",
"foregroundColor": 0,
"backgroundColor": -26368,
"businessImpact": null,
"criticalityScore": null
}
]
},
"serviceList": {
"service": [
{
"description": "Remote Desktop Services",
"name": "TermService",
"status": "started"
}
]
},
"lastLocation": {
"city": "Ashburn",
"state": "Virginia",
"country": "United States",
"name": "Ashburn, Virginia - United States",
"continent": "North America",
"postal": "20149"
},
"criticality": {
"score": 2,
"isDefault": false,
"lastUpdated": "2025-07-16T05:34:58.000Z"
},
"businessInformation": null,
"assignedLocation": null,
"businessAppListData": null,
"riskScore": null,
"passiveSensor": null,
"domain": null,
"subdomain": null,
"missingSoftware": [],
"whois": null,
"organizationName": null,
"isp": null,
"asn": null,
"easmTags": null,
"hostingCategory1": null,
"customAttributes": null,
"lparId": "113 LXAG-A72TL5-23",
"processor": {
"description": " Intel64 Family 6 Model 63 Stepping 0",
"speed": null,
"numCPUs": 1,
"noOfSocket": null,
"threadsPerCore": null,
"coresPerSocket": null,
"multithreadingStatus": null
}
}
]
}
}
Sample - Get Asset Details Using Asset by assetidSample - Get Asset Details Using Asset by assetid
API Request
curl --location --request GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=19605572
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data-raw
'<FilterRequest>'
Filter in XML
<FilterRequest>
<filters>
<Criteria field="missingSoftware.product"
operator="EQUALS"><value>Windows Defender</value></Criteria>
</filters>
</FilterRequest>
Filter in JSON
{
"filters": [
{
"field": "missingSoftware.product",
"operator": "EQUALS",
"value": " Windows Defender "
}
]
}
Response
{
"responseMessage":"Valid API Access",
"count":1,
"responseCode":"SUCCESS",
"lastSeenAssetId":null,
"hasMore":0,
"assetListData":{
"asset":[
{
"assetId":19605572,
"assetUUID":"3eb82cb6-1026-465f-a68c-94e4a95a921b",
"hostId":999990762,
"...""businessInformation":null,
"assignedLocation":null,
"businessAppListData":null,
"riskScore":null,
"passiveSensor":null,
"domain":null,
"subdomain":null,
"missingSoftware":[
{
"name":"Microsoft Windows Defender",
"category1":"Security",
"category2":"Endpoint Protection",
"publisher":"Microsoft",
"product":"Windows Defender",
"rule":"regression_14",
"criteria":[
{
"criteria":"ANY Version ",
"release":[
"ANY"
]
}
]
},
{
"name":"Microsoft Defender Advanced Threat
Protection",
"category1":"Security",
"category2":"Endpoint Protection",
"publisher":"Microsoft",
"product":"Microsoft Defender Advanced Threat
Protection",
"rule":"regression_14",
"criteria":[
{
"criteria":"ANY Version ",
"release":[
"ANY"
]
}
]
},
"..."
],
"whois":null,
"isp":null,
"asn":null,
"easmTags":null,
"..."
}
]
}
}
Sample - Get Asset Details using LPAR IDSample - Get Asset Details using LPAR ID
API Request
curl -X GET '<qualys_base_url>/rest/2.0/get/am/asset?assetId=60923488' --header 'Authorization: Bearer <JWT Token>' --header 'Content-Type: application/json' --data-raw
API Response
{
"responseMessage":"Valid API Access",
"responseCode":"SUCCESS",
"assetListData":{
"asset":[
{
"assetId":60923488,
"assetUUID":"50d20290-c66a-42e7-8c0a-ba6e92b6324c",
"hostId":1437386,
"lastModifiedDate":"2021-04-06T10:02:33.000Z",
"agentId":null,
"createdDate":"2020-11-25T12:49:25.000Z",
"sensorLastUpdatedDate":"2021-04-06T10:02:33.000Z",
"assetType":"HOST",
"address":"11.111.111.11",
"dnsName":"localhost.localdomain",
"assetName":"localhost.localdomain",
"netbiosName":null,
"timeZone":"IST",
"biosDescription":null,
"lastBoot":null,
"totalMemory":5806,
"cpuCount":null,
"lastLoggedOnUser":"root",
"hwUUID":"422a2b16-4c8b-588a-a20c-c1851ad7e376",
"biosSerialNumber":"VMware-42 2a 2b 16 4c 8b 58 8a-a2 0c c1 85 1a d7 e3 76",
"biosAssetTag":"No Asset Tag",
"isContainerHost":false,
"operatingSystem":{
"osName":"The CentOS Project CentOS 7 (1810)",
"fullName":"The CentOS Project CentOS 7 (1810)",
"category":"Linux / Server",
"category1":"Linux",
"category2":"Server",
"productName":"CentOS",
"publisher":"The CentOS Project",
"edition":null,
"marketVersion":"7",
"version":"1810",
"update":null,
"architecture":null,
"lifecycle":{
"gaDate":"2018-12-03T00:00:00.000Z",
"eolDate":"2020-12-31T00:00:00.000Z",
"eosDate":"2024-06-30T00:00:00.000Z",
"stage":"EOL",
"lifeCycleConfidence":"Exact",
"eolSupportStage":"Full updates",
"eosSupportStage":"Maintenance Updates"
},
"taxonomy":{
"id":null,
"name":"Linux / Server",
"category1":"Linux",
"category2":"Server"
},
"productUrl":"https://www.centos.org/,https://en.wikipedia.org/wiki/CentOS,",
"productFamily":null,
"installDate":null,
"release":"7.4.1708"
},
"hardware":{
"fullName":"VMware VMware Virtual Platform VMware Virtual Platform",
"category":"Virtualized / Virtual Machine",
"category1":"Virtualized",
"category2":"Virtual Machine",
"manufacturer":"VMware",
"productName":"VMware Virtual Platform",
"model":"VMware Virtual Platform",
"lifecycle":{
"introDate":null,
"gaDate":null,
"eosDate":null,
"obsoleteDate":null,
"stage":"Unknown",
"lifeCycleConfidence":" "
},
"taxonomy":{
"id":null,
"name":"Virtualized / Virtual Machine",
"category1":"Virtualized",
"category2":"Virtual Machine"
},
"productUrl":"https://www.linuxjournal.com/article/3458,,",
"productFamily":null
},
"userAccountListData":null,
"openPortListData":{
"openPort":[
{
"port":709,
"description":"",
"protocol":"UDP",
"detectedService":"portmap/rpcbind",
"firstFound":"2020-11-25T12:46:42.000Z",
"lastUpdated":"2020-11-25T12:46:42.000Z"
},
{
"port":50000,
"description":"",
"protocol":"TCP",
"detectedService":"IBM_DB2_Universal_Database",
"firstFound":"2020-11-25T12:46:42.000Z",
"lastUpdated":"2020-11-25T12:46:42.000Z"
},
{
"port":6000,
"description":"",
"protocol":"TCP",
"detectedService":"x11",
"firstFound":"2020-11-25T12:46:42.000Z",
"lastUpdated":"2020-11-25T12:46:42.000Z"
},
{
"port":22,
"description":"",
"protocol":"TCP",
"detectedService":"ssh",
"firstFound":"2020-11-25T12:46:41.000Z",
"lastUpdated":"2020-11-25T12:46:41.000Z"
},
{
"port":3389,
"description":"",
"protocol":"TCP",
"detectedService":null,
"firstFound":"2020-11-25T12:46:42.000Z",
"lastUpdated":"2020-11-25T12:46:42.000Z"
},
{
"port":111,
"description":"",
"protocol":"UDP",
"detectedService":"rpc_udp",
"firstFound":"2020-11-25T12:46:42.000Z",
"lastUpdated":"2020-11-25T12:46:42.000Z"
},
{
"port":111,
"description":"",
"protocol":"TCP",
"detectedService":"rpc",
"firstFound":"2020-11-25T12:46:41.000Z",
"lastUpdated":"2020-11-25T12:46:41.000Z"
}
]
},
"volumeListData":{
"volume":[
{
"name":"tmpfs",
"free":2737078272,
"size":3043934208
},
{
"name":"/dev/mapper/centos-home",
"free":18629619712,
"size":18700304384
},
{
"name":"devtmpfs",
"free":3026444288,
"size":3026444288
},
{
"name":"/dev/mapper/centos-root",
"free":19672580096,
"size":38304645120
},
{
"name":"/dev/sda1",
"free":876040192,
"size":1063256064
}
]
},
"networkInterfaceListData":{
"networkInterface":[
{
"hostname":"localhost.localdomain",
"addressIpV4":"111.111.111.1",
"addressIpV6":null,
"macAddress":"11:111:11:e1:71",
"interfaceName":"virbr0",
"dnsAddress":null,
"gatewayAddress":"",
"manufacturer":null,
"macVendorIntroDate":null,
"addresses":null
},
{
"hostname":"localhost.localdomain",
"addressIpV4":"11.111.111.11",
"addressIpV6":"fe80:0:0:0:250:56ff:feaa:e2da",
"macAddress":"00:00:00:aa:e2:da",
"interfaceName":"ens192",
"dnsAddress":null,
"gatewayAddress":"",
"manufacturer":"VMware",
"macVendorIntroDate":946944000000,
"addresses":null
}
]
},
"softwareListData":{
"software":[
{
"id":-5698725809391962787,
"fullName":"Python 2.7.5 64-Bit",
"softwareType":"Application",
"isIgnored":false,
"ignoredReason":null,
"category":"Application Development / Programming Languages",
"category1":"Application Development",
"category2":"Programming Languages",
"productName":"Python",
"component":null,
"publisher":"Python",
"edition":null,
"marketVersion":"2",
"version":"2.7",
"update":"2.7.5",
"architecture":"64-Bit",
"installDate":"2020-03-27T16:11:47.000Z",
"installPath":null,
"lastUpdated":"2020-11-25T12:46:46.000Z",
"lastUseDate":null,
"language":null,
"formerlyKnownAs":null,
"isPackage":false,
"isPackageComponent":false,
"packageName":null,
"productUrl":"https://en.wikipedia.org/wiki/History_of_Python,,",
"lifecycle":{
"gaDate":"2010-07-03T00:00:00.000Z",
"eolDate":"2020-01-01T00:00:00.000Z",
"eosDate":"2020-01-01T00:00:00.000Z",
"stage":"EOL/EOS",
"lifeCycleConfidence":"Exact",
"eolSupportStage":"End-of-life",
"eosSupportStage":"End-of-life"
},
"supportStageDesc":"Python's policy is to drop support major versions once they reach their end of life",
"license":{
"category":"Open Source",
"subcategory":"Python License (Python-2.0)"
},
"authorization":"Authorized"
},
{
"id":9136542396418607016,
"fullName":"OpenBSD OpenSSH Server 7.4p1",
"softwareType":"Application",
"isIgnored":false,
"ignoredReason":null,
"category":"Networking / Access Software",
"category1":"Networking",
"category2":"Access Software",
"productName":"OpenSSH",
"component":"Server",
"publisher":"OpenBSD",
"edition":null,
"marketVersion":"7",
"version":"7.4",
"update":"7.4p1",
"architecture":null,
"installDate":"2020-03-05T14:23:53.000Z",
"installPath":null,
"lastUpdated":"2020-11-25T12:46:53.000Z",
"lastUseDate":null,
"language":null,
"formerlyKnownAs":"OpenBSD Secure Shell",
"isPackage":true,
"isPackageComponent":false,
"packageName":null,
"productUrl":"https://en.wikipedia.org/wiki/OpenSSH,,",
"lifecycle":{
"gaDate":"2016-12-19T00:00:00.000Z",
"eolDate":null,
"eosDate":null,
"stage":"EOL",
"lifeCycleConfidence":"Calculated",
"eolSupportStage":" ",
"eosSupportStage":" "
},
"supportStageDesc":null,
"license":{
"category":"Open Source",
"subcategory":"BSD 2-Clause License (FreeBSD/Simplified)"
},
"authorization":"Authorized"
}
]
},
"provider":null,
"cloudProvider":null,
"agent":null,
"sensor":{
"activatedForModules":[
"VM"
],
"pendingActivationForModules":[
],
"lastVMScan":1606306572000,
"lastComplianceScan":0,
"lastFullScan":1606306572000
},
"container":null,
"inventory":{
"source":"IP",
"created":1606308565000,
"lastUpdated":1617703353000
},
"activity":null,
"tagList":{
"tag":[
{
"tagId":14151022,
"tagName":"static split",
"foregroundColor":0,
"backgroundColor":-65536,
"businessImpact":null,
"criticalityScore":2
}
]
},
"serviceList":null,
"lastLocation":null,
"criticality":{
"score":2,
"isDefault":true,
"lastUpdated":"2021-06-30T09:43:27.000Z"
},
"businessInformation":{
"company":"Qualys",
"department":"Engineering",
"ownedBy":"Paul",
"environment":"QA",
"managedBy":"Slimmer",
"supportedBy":"Nick",
"supportGroup":"ABC_01",
"operationalStatus":"Blocked"
},
"assignedLocation":{
"name":"4492 Camino De La Plaza, Pune,IN",
"city":"Pune",
"state":"MH",
"country":"IN"
},
"businessAppListData":{
"businessApp":[
{
"id":"BARCODE283904",
"name":"Quoting App",
"environment":"Production",
"businessCriticality":"2 - Less Critical",
"managedBy":"Slimmer",
"ownedBy":"Parick",
"supportedBy":"Jhon",
"supportGroup":"SME Operations",
"operationalStatus":"Mended",
"status":"Installed",
"usedFor":"Production"
},
{
"id":"BARCODE2839067gfh",
"name":"HRA",
"environment":"Production",
"businessCriticality":"1 - Most Critical",
"managedBy":"Slimmer",
"ownedBy":"Patrick",
"supportedBy":"Jhon",
"supportGroup":"SME Operations",
"operationalStatus":"broken",
"status":"Installed",
"usedFor":"Production"
}
]
},
"riskScore":690,
"passiveSensor":null,
"asn":"AS27385",
"isp":"Qualys, Inc.",
"domain":[
"qualys.com",
"qualys.in"
],
"subdomain":[
"docs.qualys.com",
"www.qualys.com"
],
"whois":[
{
"domain":"vulnerability-management.com",
"createdDate":null,
"dnssec":null,
"domainStatus":"clientTransferProhibited",
"registrantOrganization":"Qualys, Inc.",
"registrantName":null,
"registrantEmail":"[email protected]",
"registrantContact":null,
"registrar":"Gandi SAS",
"organizationName":"Qualys, Inc.",
"updatedDate":null
}"missingSoftware":null,
"customAttributes":[
{
"key":"Media State4",
"value":"Media disconnected",
"connectorName":"Qualys"
},
{
"key":"Default Gateway11",
"value":"111.111.1.1",
"connectorName":"Qualys"
},
"..."{
"key":"Subnet Mask",
"value":"222.222.222.0",
"connectorName":"Qualys"
},
"..."
],
"lparId": "6 LXAG-A72TL5-22"
"processor":null
}
]
}
Sample - Get Host Details of Specific Scanner Asset by AssetIdSample - Get Host Details of Specific Scanner Asset by AssetId
API Request
curl --location
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=16587699' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <JWT_Token>'
API Response
{ "responseMessage": "Valid API Access", "count": 1, "responseCode": "SUCCESS", "lastSeenAssetId": null, "hasMore": 0, "assetListData": { "asset": [ { "assetId": 16587699, "assetUUID": "b516ea66-6921-9451-e053-2a4f2c0a1522", "hostId": null, "lastModifiedDate": "2024-09-17T05:27:06.000Z", "agentId": null, "createdDate": "2020-11-27T12:36:55.000Z", "sensorLastUpdatedDate": "2024-09-17T05:27:06.000Z", "assetType": "SCANNER", "address": null, "dnsName": null, "assetName": "POD04-Scanner", "netbiosName": null, "timeZone": null, "biosDescription": null, "lastBoot": null, "totalMemory": null, "cpuCount": null, "lastLoggedOnUser": null, "domainRole": null, "hwUUID": null, "biosSerialNumber": null, "biosAssetTag": null, "isContainerHost": null, "operatingSystem": null, "hardware": null, "userAccountListData": null, "openPortListData": null, "volumeListData": null, "networkInterfaceListData": null, "softwareListData": null, "softwareComponent": null, "provider": null, "cloudProvider": null, "agent": null, "sensor": null, "container": null, "inventory": null, "activity": null, "tagList": { "tag": [ { "tagId": 134046247, "tagName": "BU-specAG11", "foregroundColor": 0, "backgroundColor": 0, "businessImpact": null, "criticalityScore": null }, { "tagId": 142628002, "tagName": "testscan1", "foregroundColor": 0, "backgroundColor": 0, "businessImpact": null, "criticalityScore": null }, ] }, "serviceList": null, "lastLocation": null, "criticality": null, "businessInformation": null, "assignedLocation": null, "businessAppListData": null, "riskScore": null, "passiveSensor": null, "domain": null, "subdomain": null, "missingSoftware": null, "whois": null, "organizationName": null, "isp": null, "asn": null, "easmTags": null, "hostingCategory1": null, "customAttributes": null, "processor": null } ] } }
Sample - "hostingCategory1" InformationSample - "hostingCategory1" Information
API Request
curl --location --request GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=22303276'
--header'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
Response
"responseMessage":"Valid API Access",
"count":1,
"responseCode":"SUCCESS",
"lastSeenAssetId":null,
"hasMore":0,
"assetListData":{
"asset":[
{
"assetId":22303276,
"assetUUID":"383c0696-0ac9-42f8-8189-28b7e81f4bb0",
"hostId":null,
"...""missingSoftware":null,
"whois":[
{
"domain":"blujaysolutions.com",
"createdDate":"2016-11-30T00:00:00.000Z",
"..."
}
],
"isp":"Amazon.com, Inc.",
"asn":"AS16509",
"easmTags":[
"cloud"
],
"hostingCategory1":"ThirdParty",
"customAttributes":null,
"processor":null
}
]
}
}
We also support this for includeFields and excludeFields. See the following example.
ExampleExample
API Request
curl --location --request GET
'<qualys_base_url>/rest/2.0/get/am/asset?
assetId=22303276&includeFields=hostingCategory1'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
Response
{
"responseMessage":"Valid API Access",
"count":1,
"responseCode":"SUCCESS",
"lastSeenAssetId":null,
"hasMore":0,
"assetListData":{
"asset":[
{
"assetId":22303276,
"assetUUID":"383c0696-0ac9-42f8-8189-28b7e81f4bb0",
"hostId":null,
"...""missingSoftware":null,
"whois":null,
"isp":null,
"asn":null,
"easmTags":null,
"hostingCategory1":"ThirdParty",
"customAttributes":null,
"processor":null
}
]
}
Example: Added "easmTags" InformationExample: Added "easmTags" Information
API Request
curl --location --request GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=22303132'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
Response
{
"responseMessage": "Valid API Access",
"count": 1,
"responseCode": "SUCCESS",
"lastSeenAssetId": null,
"hasMore": 0,
"assetListData": {
"asset": [
{
"assetId": 22303132,
"assetUUID": "xxx69134-dcxx-4e65-xxce-74f3e60caxxx",
"hostId": null,
...
"missingSoftware": null,
"whois": [
{
"domain": "totalcloud.io",
...
"registrar": "GoDaddy.com, LLC",
"organizationName": null,
"updatedDate": null
}
],
"isp": "Amazon.com, Inc.",
"asn": "AS16509",
"easmTags": [
"cloud",
"cdn"
],
"hostingCategory1": "Unknown",
"customAttributes": null,
"processor": null
}
]
}
}
We also support this for includeFields and excludeFields. See the following example.
ExampleExample
API Request
curl --location --request GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=22303132&includeFields=easmTags'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
Response
{
"responseMessage": "Valid API Access",
"count": 1,
"responseCode": "SUCCESS",
"lastSeenAssetId": null,
"hasMore": 0,
"assetListData": {
"asset": [
{
"assetId": 22303132,
"assetUUID": "c9669134-dcb4-4e65-94ce-74f3e60ca697",
"hostId": null,
...
"riskScore": null,
"passiveSensor": null,
"domain": null,
"subdomain": null,
"missingSoftware": null,
"whois": null,
"isp": null,
"asn": null,
"easmTags": [
"cloud",
"cdn"
],
"hostingCategory1": null,
"customAttributes": null,
"processor": null
}
]
}
}
For the supported tokens and operator list, refer to Supported Operators.