CyberSecurity Asset Management/Global AssetView Release 3.6.0.0 API
August 19, 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.
Enhanced Typosquatted Domain APIs
We have enhanced the Typosquatted Domain APIs to support new DNS-based filters. You can now fetch typosquatted domains by DNS type, source, and value using the following APIs:
To get the DNS data of the Typosquatted domains, you must use the new input parameter and filters in the above APIs.
New Input Parameter
Parameter | Mandatory/ Optional |
Data Type | Description |
---|---|---|---|
includeFields | Optional
(Mandatory when you want to fetch the DNS data) |
String | Use this parameter to include the DNS data of typosquatted domains in the API response. The value for fetching the DNS data is:
|
New Filters
Filtering Parameter | Mandatory/ Optional |
Data Type | Supported Operators | Description |
---|---|---|---|---|
dns.type | Optional | String | CONTAINS, IN, EQUALS, NOT EQUALS | Filter typosquatted domains by DNS type. |
dns.source | Optional | String | CONTAINS, IN, EQUALS, NOT EQUALS | Filter typosquatted domains by the DNS source. |
dns.value | Optional | String | CONTAINS, IN, EQUALS, NOT EQUALS | Filter typosquatted domains by the DNS value. |
Get the List of Typosquatted Domains API: Filter the list using the DNS filters
New or Updated API | Updated |
API Endpoint | /rest/2.0/am/domain/list |
Method | POST |
DTD or XSD changes | Not Applicable |
Use this API to fetch a list of typosquatted domains filtered by DNS type, source, or value.
API Request
curl -X POST
'<qualys_base_url>/rest/2.0/am/domain/list?domainType=TYPOSQUATTED_DOMAINS&includeFields=DNS'
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer <JWT Token>'
--data '
<FilterRequest>
<filters>
<Criteria field="dns.source" operator="EQUALS">
<value>Google DNS</value>
</Criteria>
<Criteria field="permutation.name" operator="EQUALS">
<value>aday.io</value>
</Criteria>
<Criteria field="dns.type" operator="EQUALS">
<value>A</value>
</Criteria>
<Criteria field="dns.value" operator="EQUALS">
<value>xx.xxx.xxx.xx</value>
</Criteria>
</filters>
<operation>AND</operation>
</FilterRequest>
API Response
{
"responseMessage": "Valid API Access",
"responseCode": "SUCCESS",
"hasMore": 0,
"count": 1,
"lastFetchDomainId": 655391026,
"domainListData": {
"domains": [
{
"domain": "domain",
"whoIs": {
"registrar": "Domain.com, LLC",
"registrantOrg": "Domains By Proxy, LLC",
"registrantEmailId": null,
"creationDate": "2019-07-01",
"registrantCountry": "UNITED STATES",
"expirationDate": "2025-07-01"
},
"ips": [
"xx.xxx.xxx.xx",
"xx.xxx.xx.xxx"
],
"permutation": {
"name": "Domain",
"category": "Transposition",
"types": []
},
"dns": [
{
"type": "A",
"value": "xx.xxx.xxx.xx",
"sources": [
"Google DNS"
]
},
{
"type": "A",
"value": "xx.xxx.xx.xxx",
"sources": [
"Google DNS"
]
}
]
}
]
}
}
Get the Count of Typosquatted Domains API: Filter the domain count using the DNS filters
New or Updated API | Updated |
API Endpoint | /rest/2.0/am/domain/count |
Method | POST |
DTD or XSD changes | Not Applicable |
Use this API to fetch the count of typosquatted domains filtered by DNS type, source, or value.
API Request
curl -X POST
'<qualys_base_url>/rest/2.0/am/domain/count?domainType=TYPOSQUATTED_DOMAINS&includeFields=DNS
'
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer <JWT Token>'
--data
'<FilterRequest>
<filters>
<Criteria field="dns.source" operator="EQUALS">
<value>Google DNS</value>
</Criteria>
</filters>
</FilterRequest>'
API Response
{
"count": 1,
"responseCode": "SUCCESS",
"responseMessage": "Valid API Access"
}
EASM Profile APIs Enhanced with Domain Security Details
You can now enable, disable, or fetch the Domain Security details for an EASM profile using the EASM profile APIs. A new enableDomainSecurity
parameter is introduced to the following APIs:
- Create EASM Profile API
- Update EASM Profile Data API
- Patch EASM Profile Data API
- Get EASM Profile Data API
For more information on Domain Security, refer to the CSAM 3.6 Release Notes.
New Parameter
Parameter |
Mandatory |
Data Type |
Description |
---|---|---|---|
enableDomainSecurity | Optional | Boolean | Provide the value as true or false to enable or disable the Domain Security feature for an EASM profile. |
Create EASM Profile API: Introduced a new input parameter
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 with the domain security enabled.
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": false,
"includeVMAssets": false,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": true
}'
API Response
{
"code": "201",
"status": "SAVED",
"date": "2024-01-15 10:08:53",
"message": "Profile Created Successfully."
}
Update EASM Profile Data API: Introduced a new input parameter
New or Updated API | Updated |
API Endpoint | /easm/v2/profile/{profileName} |
Method | PUT |
DTD or XSD changes | Not Applicable |
Use this API to update the enableDomainSecurity
parameter in an EASM profile using the PUT method.
API Request
curl -X PUT
'<qualys_base_url>/easm/v2/profile/EASM_Profile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer '
--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
}'
API Response
{
"code": "200",
"status": "UPDATED",
"date": "2024-01-15 10:59:08",
"message": "Profile Updated Successfully"
}
Patch EASM Profile Data API: Introduced a new input parameter
New or Updated API | Updated |
API Endpoint | /easm/v2/profile/{profileName} |
Method | PATCH |
DTD or XSD changes | Not Applicable |
Use this API to update the enableDomainSecurity
parameter in an EASM profile using the PATCH method.
API Request
curl -X PUT
'<qualys_base_url>/easm/v2/profile/EASM_Profile'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer '
--data '{
"excludeSeeds": [],
"enableIFAScan": false,
"active": true,
"enableEASMScan": false,
"includeVMAssets": false,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": true,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": false
}'
API Response
{
"code": "200",
"status": "UPDATED",
"date": "2024-01-15 10:59:08",
"message": "Profile Updated Successfully"
}
Get EASM Profile Data API: Introduced a new parameter in response
New or Updated API | Updated |
API Endpoint | /easm/v2/profile |
Method | GET |
DTD or XSD changes | Not Applicable |
Use this API to fetch EASM profile details and check whether the domain security setting is enabled for that profile.
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": "profile name",
"includeSeeds": [
{
"seedType": "ORGANIZATION",
"seedValue": "Qualys, Inc",
"seedHeading": null,
"enumerateSubsidiary": true,
"horizontalEnumeration": true,
"seedFilters": [],
"verticalEnumeration": false,
"seedFileName": null
},
{
"seedType": "DOMAIN",
"seedValue": "qualys.com",
"seedHeading": null,
"enumerateSubsidiary": true,
"horizontalEnumeration": true,
"seedFilters": [],
"verticalEnumeration": true,
"seedFileName": null
}
],
"excludeSeeds": [
{
"seedType": "COUNTRY",
"seedValue": "IN"
}
],
"enableIFAScan": false,
"active": false,
"profileTagName": "tag name",
"enableEASMScan": false,
"includeVMAssets": false,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 3,
"excludeDefamatoryDomain": false,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": false
},
{
"name": "MultipleIPS",
"includeSeeds": [
{
"seedType": "NETBLOCK",
"seedValue": "xxx.xx.xxx.x;xxx.xx.xx.xxx;xx.xx.xxx.xx",
"seedHeading": null,
"enumerateSubsidiary": false,
"horizontalEnumeration": false,
"seedFilters": [],
"verticalEnumeration": false,
"seedFileName": null
}
],
"excludeSeeds": [],
"enableIFAScan": false,
"active": true,
"profileTagName": "MultipleIPS",
"enableEASMScan": false,
"includeVMAssets": false,
"excludeCDNAssets": true,
"defaultPurgeRuleFrequency": 2,
"excludeDefamatoryDomain": false,
"enableTyposquattedDomainGeneration": false,
"enableDomainSecurity": true
}
]
}
New Software Lifecycle Information in Asset APIs
Asset APIs can now fetch assets that have software with the Publicly Unavailable lifecycle status. This information is available in the response of the following APIs:
For more information, refer to the CSAM 3.6 Release Notes.
Get Host Details of Specific Asset API
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 fetch software lifecycle information of a specific asset that is Publicly Unavailable.
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
},
"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
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 software lifecycle information of all asset that is Publicly Unavailable.
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": " ",
"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
},
"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
}
}
]
}
}