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:

includeFields=DNS

 

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.

Sample: Fetch a list of typosquatted domains using the dns filtersSample: Fetch a list of typosquatted domains using the dns filters

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.

Sample: Fetch the count of typosquatted domains using the dns filtersSample: Fetch the count of typosquatted domains using the dns filters

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:

For more information on Domain Security, refer to the CSAM 3.6 Release Notes.

New Parameter

Parameter

Mandatory
/Optional

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.

Sample: Update an EASM profile using the PUT methodSample: Update 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.

Sample: Update an EASM profile using the PATCH methodSample: Update 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
        }
      }
    ]
  }
}