CyberSecurity Asset Management/Global AssetView Release 3.6.1.0 API
September 30, 2025
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.
Filter Assets by Agent Activation Key and Status
We have added support for filtering assets based on the activation key and status of the installed agent.
You can now use the following filters in the Get Host Details of All Assets API:
| Filter | Description |
|---|---|
| agent.activationsKey | Filter assets using the activation key of the installed agent. |
| agent.activationsStatus | Filter assets using the activation status of the installed agent. |
Get Host Details of All Assets API: Filter assets by activation status or key
| 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 fetch assets based on the agent activation key or activation status.
Sample: Fetch asset details using filtersSample: Fetch asset details using filters
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'
-data-raw
Filter in XML
<FilterRequest>
<filters>
<Criteria field="agent.activationsStatus" operator="EQUALS">
<value>ACTIVE</value>
</Criteria>
</filters>
</FilterRequest>
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
},
"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": "Security",
"eosSupportStage": "End of Life",
"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
}
}
]
}
}
Asset APIs Enhanced with Asset Source Details
We have enhanced the Asset APIs to provide visibility into all the sources from which an asset is discovered. The API response now includes a new parameter that lists these discovery sources.
| Parameter | Description | |
|---|---|---|
| inventoryListData | Lists all sources of the asset. | |
| inventory | Provides an array containing the sources (for example, Active Directory, IP Scanner), along with the asset creation time and last updated time. | |
Impacted APIs
The following APIs are impacted due to the new parameter:
Get Host Details of Specific Asset: Fetch all asset sources
| 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 retrieve details of all sources from which the specified asset is discovered.
Sample: Fetch details of a specific assetSample: Fetch details of a specific asset
API Request
curl -X GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=69169700'
-H "Authorization: Bearer <JWTToken>"
-H "Content-Type: application/json"
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
},
"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
}
}
]
}
}
Get Host Details of All Assets: Fetch all asset sources
| 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 retrieve details of all sources from which each asset is discovered.
Sample: Fetch details of all assetsSample: Fetch details of all assets
API Request
curl -X POST
'<qualys_base_url>/rest/2.0/search/am/asset'
-H "Authorization: Bearer <JWTToken>"
-H "Content-Type: application/json"
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
},
"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": "Security",
"eosSupportStage": "End of Life",
"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
}
}
]
}
}
EASM Lightweight Scan Scope Configuration through EASM Profile APIs
The EASM Profile APIs are now enhanced with new input parameters, which enable you to limit the scope of EASM lightweight scans using asset tags. With these parameters, you can include or exclude assets from the scan.
This feature is accessible only when the EASM scan is enabled for a profile by setting the enableEASMScan parameter to true.
New Input Parameters
|
Parameter |
Mandatory |
Data Type |
Description |
|
|---|---|---|---|---|
| easmScanAssetsScoping | Optional | Object | Define the scope to include or exclude assets from an EASM scan based on asset tags. | |
| includeType | Optional | String | Provide the condition for including assets in the EASM scan.
Accepted values:
|
|
| includeTagIds | Optional | Integer | Provide the list of asset tag IDs to include in the EASM scan. | |
| excludeType | Optional | String | Provide the condition for excluding assets from the EASM scan.
Accepted values:
|
|
| excludeTagIds | Optional | Integer | Provide the list of asset tag IDs to exclude from the EASM scan. | |
Impacted APIs
The following APIs are impacted due to the new input parameters:
- Get EASM Profile Data API
- Create EASM Profile API
- Update EASM Profile Data API
- Patch EASM Profile Data API
Get EASM Profile Data API: Fetch EASM scan scope
| New or Updated API | Updated |
| API Endpoint | /easm/v2/profile |
| Method | GET |
| DTD or XSD changes | Not Applicable |
Use this API to fetch the EASM Scan scope details of all EASM profiles. The scope information is provided in the easmScanAssetsScoping parameter of the response. If no asset tags are specified in the scope, the easmScanAssetsScoping parameter is returned as null.
Sample: Fetch an EASM profile detailsSample: Fetch an EASM profile details
API Request
curl -X GET
'<qualys_base_url>/easm/v2/profile'
--header 'Authorization: Bearer <JWT_Token>'
--data ''
API Response
{
"hasNextPage": false,
"profile": [
{
"name": "NewProfile",
"includeSeeds": [
{
"seedType": "NETBLOCK",
"seedValue": "169.xx.xxx.8;108.xxx.xxx.31",
"seedHeading": null,
"enumerateSubsidiary": false,
"horizontalEnumeration": false,
"seedFilters": [],
"verticalEnumeration": false,
"seedFileName": null
}
],
"excludeSeeds": [],
"enableIFAScan": false,
"active": true,
"profileTagName": "Tag name",
"enableEASMScan": true,
"includeVMAssets": true,
"excludeCDNAssets": false,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": false,
"easmScanAssetsScoping": {
"includeType": "Any",
"includeTagIds": [
51672174
],
"excludeType": "Any",
"excludeTagIds": []
}
},
{
"name": "exlusion",
"includeSeeds": [
{
"seedType": "NETBLOCK",
"seedValue": "169.xx.xx.xxx",
"seedHeading": null,
"enumerateSubsidiary": false,
"horizontalEnumeration": false,
"seedFilters": [],
"verticalEnumeration": false,
"seedFileName": null
}
],
"excludeSeeds": [
{
"seedType": "NETBLOCK",
"seedValue": "169.xx.xx.xxx",
"seedFileName": null
},
{
"seedType": "NETBLOCK",
"seedValue": "2620:xxx:xxxx:0:0:0:0:2;xxxx:xxxx:0:0:0:0:xxxx:xxxx",
"seedFileName": null
}
],
"enableIFAScan": false,
"active": false,
"profileTagName": "exlusion",
"enableEASMScan": true,
"includeVMAssets": true,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": false,
"easmScanAssetsScoping": null
}
]
}
Create EASM Profile API: Limit EASM scan scope
| New or Updated API | Updated |
| API Endpoint | /easm/v2/profile |
| Method | POST |
| DTD or XSD changes | Not Applicable |
Use this API to create an EASM profile that is configured to perform the EASM scan on selected assets.
Sample: Create an EASM profileSample: Create an EASM profile
API Request
curl -X POST
'<qualys_base_url>/easm/v2/profile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT_Token>'
--data '{
"name": "NewProfile",
"includeSeeds": [
{
"seedType": "DOMAIN",
"seedValue": "domain.com",
"enumerateSubsidiary": false,
"horizontalEnumeration": false,
"seedFilters": [],
"verticalEnumeration": false,
"seedFileName": null
}
],
"excludeSeeds": [],
"enableIFAScan": false,
"active": true,
"enableEASMScan": true,
"includeVMAssets": true,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": true,
"easmScanAssetsScoping": {
"includeType": "ANY",
"includeTagIds": [
51604974
],
"excludeType": "ANY",
"excludeTagIds": [
49218939
]
}
}'
API Response
{
"code": "201",
"status": "SAVED",
"date": "2024-01-15 10:08:53",
"message": "Profile Created Successfully."
}
Update EASM Profile Data API: Manage EASM scan scope
| New or Updated API | Updated |
| API Endpoint | /easm/v2/profile/{profileName} |
| Method | PUT |
| DTD or XSD changes | Not Applicable |
Use this API to add or remove the asset tags from the EASM scan using the PUT method.
API Request
curl -X PUT
'<qualys_base_url>/easm/v2/profile/NewProfile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT_Token>'
--data '{
"name": "NewProfile",
"includeSeeds": [
{
"seedType": "DOMAIN",
"seedValue": "domain.com",
"enumerateSubsidiary": false,
"horizontalEnumeration": false,
"seedFilters": [],
"verticalEnumeration": false,
"seedFileName": null
}
],
"excludeSeeds": [],
"enableIFAScan": false,
"active": true,
"enableEASMScan": false,
"includeVMAssets": false,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": false,
"easmScanAssetsScoping": {
"includeType": "ANY",
"includeTagIds": [
51604974
],
"excludeType": "ANY",
"excludeTagIds": [
49218939
]
}
}'API Response
{
"code": "200",
"status": "UPDATED",
"date": "2024-01-15 10:59:08",
"message": "Profile Updated Successfully"
}
Patch EASM Profile Data API: Manage EASM scan scope
| New or Updated API | Updated |
| API Endpoint | /easm/v2/profile/{profileName} |
| Method | PATCH |
| DTD or XSD changes | Not Applicable |
Use this API to add or remove the asset tags from the EASM scan using the PATCH method.
API Request
curl -X PATCH
'<qualys_base_url>/easm/v2/profile/NewProfile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT_Token>'
--data '{
"name": "NewProfile",
"enableIFAScan": false,
"active": true,
"enableEASMScan": false,
"includeVMAssets": false,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": false,
"easmScanAssetsScoping": {
"includeType": "ANY",
"includeTagIds": [
51604974
],
"excludeType": "ANY",
"excludeTagIds": [
49218939
]
}
}'API Response
{
"code": "200",
"status": "UPDATED",
"date": "2024-01-15 10:59:08",
"message": "Profile Updated Successfully"
}