CyberSecurity Asset Management/Global AssetView Release 3.7.2.0 API
June 24, 2026
Before understanding the API release highlights, learn more about the API server URL to be used in your API requests by referring to the Know Your Qualys API Server URL section. For this API Release Notes, <qualys_base_url> is mentioned in the sample API requests.
Support for AI-powered Asset Criticality Score in Asset Host Data APIs
You can now fetch criticality score details for assets whose criticality scores are calculated using the AI-powered Asset Criticality Score (ACS). To support this capability, we have introduced the following input filters to the Asset Host Data APIs:
| Input Filter | Mandatory/Optional | Data Type | Description |
|---|---|---|---|
| asset.hasAiCriticalityScore | Optional | Boolean | Filters assets based on whether an AI-generated criticality score is available. |
| asset.aiCriticalityScoreConfidence | Optional | String | Filters assets based on the confidence level of the AI-generated criticality score. Supported values include HIGH. and LOW. |
Impacted APIs
The following Asset Host Data APIs are updated to provide AI-powered Asset Criticality Score (ACS) information:
- Get Host Details of Specific Asset
- Get Host Details of All Assets
New Response Parameters
The response of the impacted Asset Host Data APIs includes the details of the criticality score:
| Response Parameter | Data Type | Description |
|---|---|---|
| hasAiCriticalityScore | Boolean | Provides whether the asset has an AI ACS score. |
| aiCriticalityScoreConfidence | String | Provides the confidence level of the AI ACS score. |
| default | Boolean | Provides whether the asset is using the default criticality configuration. |
Updated API: Get Host Details of Specific Asset
| New or Updated API | Updated |
| API Endpoint | /rest/2.0/get/am/asset |
| Method | GET |
| DTD or XSD changes | Not Applicable |
Use this API to get details of the AI ACS score of a specific asset.
API Request
curl -X GET
"<qualys_base_url>/rest/2.0/get/am/asset?assetId=8194990"
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
API Request body with new filter
"filters": [
{
"field": "asset.hasAiCriticalityScore",
"operator": "EQUALS",
"value": "true"
}
]
API Request body with new filter
"filters": [ { "field": "asset.aiCriticalityScoreConfidence", "operator": "EQUALS", "value": "LOW" } ]
API 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
},
"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...",
"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"
}
]
},
"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
}
]
},
"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
},
"inventory": {
"source": "IP",
"created": 1752644100000,
"lastUpdated": 1752644100000
},
"activity": {
"source": "IP",
"lastScannedDate": 1752644100000
},
"lastLocation": {
"city": "Ashburn",
"state": "Virginia",
"country": "United States",
"name": "Ashburn, Virginia - United States",
"continent": "North America",
"postal": "20149"
},
"criticality": {
"aiCriticalityScoreConfidence": "LOW",
"hasAiCriticalityScore": true,
"default": false,
"score": 4,
"isDefault": false,
"lastUpdated": "2026-05-18T14:19:25.000Z"
},
"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
}
}
]
}
}
Updated API: Get Host Details of All Assets
| New or Updated API | Updated |
| API Endpoint | /rest/2.0/search/am/asset |
| Method | POST |
| DTD or XSD changes | Not Applicable |
Use this API to get details of the AI ACS score of all assets.
Sample: Get details of all assetSample: Get details of all asset
API Request
curl -X POST
"<qualys_base_url>/rest/2.0/search/am/asset"
-H "Accept: application/json"
-H "Authorization: Bearer <JWTToken>"
-H "Content-Type: application/json"
API Request body with new filter
"filters": [
{
"field": "asset.hasAiCriticalityScore",
"operator": "EQUALS",
"value": "true"
}
]API Request body with new filter
"filters": [ { "field": "asset.aiCriticalityScoreConfidence", "operator": "EQUALS", "value": "LOW" } ]
API Response
{
"responseMessage": "Valid API Access",
"count": 1,
"responseCode": "SUCCESS",
"lastSeenAssetId": 6920718,
"hasMore": 1,
"assetListData": {
"asset": [
{
"assetId": 6920718,
"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": "10.115.110.95",
"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",
"marketVersion": "7",
"version": "1810",
"release": "7.4.1708",
"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"
}
},
"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"
},
"openPortListData": {
"openPort": [
{
"port": 22,
"protocol": "TCP",
"detectedService": "ssh"
},
{
"port": 3389,
"protocol": "TCP"
},
{
"port": 6000,
"protocol": "TCP",
"detectedService": "x11"
},
{
"port": 50000,
"protocol": "TCP",
"detectedService": "IBM_DB2_Universal_Database"
},
{
"port": 111,
"protocol": "TCP",
"detectedService": "rpc"
},
{
"port": 111,
"protocol": "UDP",
"detectedService": "rpc_udp"
}
]
},
"volumeListData": {
"volume": [
{
"name": "tmpfs",
"free": 2737078272,
"size": 3043934208
},
{
"name": "/dev/mapper/centos-home",
"free": 18629619712,
"size": 18700304384
},
{
"name": "/dev/mapper/centos-root",
"free": 19672580096,
"size": 38304645120
}
]
},
"networkInterfaceListData": {
"networkInterface": [
{
"hostname": "localhost.localdomain",
"addressIpV4": "10.115.110.95",
"interfaceName": "ens192",
"macAddress": "00:50:56:aa:e2:da"
}
]
},
"softwareListData": {
"software": [
{
"fullName": "Python 2.7.5 64-Bit",
"version": "2.7",
"publisher": "Python",
"category": "Application Development / Programming Languages"
},
{
"fullName": "OpenBSD OpenSSH Server 7.4p1",
"version": "7.4",
"publisher": "OpenBSD",
"category": "Networking / Access Software"
}
]
},
"inventory": {
"source": "IP",
"created": 1606308565000,
"lastUpdated": 1617703353000
},
"sensor": {
"activatedForModules": ["VM"],
"lastVMScan": 1606306572000,
"lastFullScan": 1606306572000
},
"tagList": {
"tag": [
{
"tagId": 14151022,
"tagName": "static split",
"criticalityScore": 3
}
]
},
"criticality": {
"aiCriticalityScoreConfidence": "LOW",
"hasAiCriticalityScore": true,
"default": false,
"score": 4,
"isDefault": false,
"lastUpdated": "2026-05-18T14:19:25.000Z"
},
"businessInformation": {
"company": "Qualys",
"department": "Engineering",
"ownedBy": "Paul",
"environment": "QA"
},
"assignedLocation": {
"name": "4492 Camino De La Plaza, Pune,IN",
"city": "Pune",
"state": "MH",
"country": "IN"
},
"riskScore": 690,
"asn": "AS27385",
"isp": "Qualys, Inc."
}
]
}
}