CyberSecurity Asset Management/Global AssetView Release 3.5.0.0 API

May 16, 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.

LPAR ID Filtering Support for Asset APIs

With this release, we have enhanced the asset APIs to support LPAR ID-based filtering. This improvement allows you to fetch asset details specific to a particular LPAR. 

You must provide the LPAR ID in the filter of the API request. Currently, the APIs support the filter in XML format.

The following V2 APIs are impacted:

We have also extended the support to the following V1 APIs:

  • List Host details of specific asset (/am/v1/asset/host/id)
  • List details of all asset (/am/v1/assets/host/list)
  • Get Count of all Assets (/am/v1/assets/host/count)
  • List Asset Host Details based on Filter (/am/v1/assets/host/filter/list)

For V1 APIs, you must provide the LPAR ID as filter in the API URLs. For example, refer to the List Asset Host Details based on Filter API. To learn more about these APIs, refer to the CSAM V1 API User Guide.

Input Parameters

The following filtering parameter is introduced:

Filtering Parameter Mandatory/
Optional
Data Type Supported Operators Description
asset.
lparID
Optional String - EQUALS

- IN

Provide the specific LPAR ID value to fetch only those assets that match the given identifier. This parameter helps narrow down the asset list based on their associated LPAR ID.

Updated API: Get Host Details of Specific Asset

New or Updated API Updated
API Endpoint /rest/2.0/get/am/asset
Method GET
DTD or XSD changes Not Applicable

Use this API to fetch the LPAR ID associated with the specified asset ID.

Sample: Fetch the LPAR ID associated with the specific asset IDSample: Fetch the LPAR ID associated with the specific asset ID

API Request

curl -X GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=60923488'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/json'
--data-raw

API Response

{
   "responseMessage":"Valid API Access",
   "responseCode":"SUCCESS",
   "assetListData":{
      "asset":[
         {
            "assetId":60923488,
            "assetUUID":"50d20290-c66a-42e7-8c0a-ba6e92b6324c",
            "hostId":1437386,
            "lastModifiedDate":"2021-04-06T10:02:33.000Z",
            "agentId":null,
            "createdDate":"2020-11-25T12:49:25.000Z",
            "sensorLastUpdatedDate":"2021-04-06T10:02:33.000Z",
            "assetType":"HOST",
            "address":"11.111.111.11",
            "dnsName":"localhost.localdomain",
            "assetName":"localhost.localdomain",
            "netbiosName":null,
            "timeZone":"IST",
            "biosDescription":null,
            "lastBoot":null,
            "totalMemory":5806,
            "cpuCount":null,
            "lastLoggedOnUser":"root",
            "hwUUID":"422a2b16-4c8b-588a-a20c-c1851ad7e376",
            "biosSerialNumber":"VMware-42 2a 2b 16 4c 8b 58 8a-a2 0c c1 85 1a d7 e3 76",
            "biosAssetTag":"No Asset Tag",
            "isContainerHost":false,
            "operatingSystem":{
               "osName":"The CentOS Project CentOS 7 (1810)",
               "fullName":"The CentOS Project CentOS 7 (1810)",
               "category":"Linux / Server",
               "category1":"Linux",
               "category2":"Server",
               "productName":"CentOS",
               "publisher":"The CentOS Project",
               "edition":null,
               "marketVersion":"7",
               "version":"1810",
               "update":null,
               "architecture":null,
               "lifecycle":{
                  "gaDate":"2018-12-03T00:00:00.000Z",
                  "eolDate":"2020-12-31T00:00:00.000Z",
                  "eosDate":"2024-06-30T00:00:00.000Z",
                  "stage":"EOL",
                  "lifeCycleConfidence":"Exact",
                  "eolSupportStage":"Full updates",
                  "eosSupportStage":"Maintenance Updates"
               },
               "taxonomy":{
                  "id":null,
                  "name":"Linux / Server",
                  "category1":"Linux",
                  "category2":"Server"
               },
               "productUrl":"https://www.centos.org/,https://en.wikipedia.org/wiki/CentOS,",
               "productFamily":null,
               "installDate":null,
               "release":"7.4.1708"
            },
            "hardware":{
               "fullName":"VMware VMware Virtual Platform VMware Virtual Platform",
               "category":"Virtualized / Virtual Machine",
               "category1":"Virtualized",
               "category2":"Virtual Machine",
               "manufacturer":"VMware",
               "productName":"VMware Virtual Platform",
               "model":"VMware Virtual Platform",
               "lifecycle":{
                  "introDate":null,
                  "gaDate":null,
                  "eosDate":null,
                  "obsoleteDate":null,
                  "stage":"Unknown",
                  "lifeCycleConfidence":" "
               },
               "taxonomy":{
                  "id":null,
                  "name":"Virtualized / Virtual Machine",
                  "category1":"Virtualized",
                  "category2":"Virtual Machine"
               },
               "productUrl":"https://www.linuxjournal.com/article/3458,,",
               "productFamily":null
            },
            "userAccountListData":null,
            "openPortListData":{
               "openPort":[
                  {
                     "port":709,
                     "description":"",
                     "protocol":"UDP",
                     "detectedService":"portmap/rpcbind",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":50000,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"IBM_DB2_Universal_Database",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":6000,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"x11",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":22,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"ssh",
                     "firstFound":"2020-11-25T12:46:41.000Z",
                     "lastUpdated":"2020-11-25T12:46:41.000Z"
                  },
                  {
                     "port":3389,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":null,
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":111,
                     "description":"",
                     "protocol":"UDP",
                     "detectedService":"rpc_udp",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":111,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"rpc",
                     "firstFound":"2020-11-25T12:46:41.000Z",
                     "lastUpdated":"2020-11-25T12:46:41.000Z"
                  }
               ]
            },
            "volumeListData":{
               "volume":[
                  {
                     "name":"tmpfs",
                     "free":2737078272,
                     "size":3043934208
                  },
                  {
                     "name":"/dev/mapper/centos-home",
                     "free":18629619712,
                     "size":18700304384
                  },
                  {
                     "name":"devtmpfs",
                     "free":3026444288,
                     "size":3026444288
                  },
                  {
                     "name":"/dev/mapper/centos-root",
                     "free":19672580096,
                     "size":38304645120
                  },
                  {
                     "name":"/dev/sda1",
                     "free":876040192,
                     "size":1063256064
                  }
               ]
            },
            "networkInterfaceListData":{
               "networkInterface":[
                  {
                     "hostname":"localhost.localdomain",
                     "addressIpV4":"111.111.111.1",
                     "addressIpV6":null,
                     "macAddress":"11:111:11:e1:71",
                     "interfaceName":"virbr0",
                     "dnsAddress":null,
                     "gatewayAddress":"",
                     "manufacturer":null,
                     "macVendorIntroDate":null,
                     "addresses":null
                  },
                  {
                     "hostname":"localhost.localdomain",
                     "addressIpV4":"11.111.111.11",
                     "addressIpV6":"fe80:0:0:0:250:56ff:feaa:e2da",
                     "macAddress":"00:00:00:aa:e2:da",
                     "interfaceName":"ens192",
                     "dnsAddress":null,
                     "gatewayAddress":"",
                     "manufacturer":"VMware",
                     "macVendorIntroDate":946944000000,
                     "addresses":null
                  }
               ]
            },
            "softwareListData":{
               "software":[
                  {
                     "id":-5698725809391962787,
                     "fullName":"Python 2.7.5 64-Bit",
                     "softwareType":"Application",
                     "isIgnored":false,
                     "ignoredReason":null,
                     "category":"Application Development / Programming Languages",
                     "category1":"Application Development",
                     "category2":"Programming Languages",
                     "productName":"Python",
                     "component":null,
                     "publisher":"Python",
                     "edition":null,
                     "marketVersion":"2",
                     "version":"2.7",
                     "update":"2.7.5",
                     "architecture":"64-Bit",
                     "installDate":"2020-03-27T16:11:47.000Z",
                     "installPath":null,
                     "lastUpdated":"2020-11-25T12:46:46.000Z",
                     "lastUseDate":null,
                     "language":null,
                     "formerlyKnownAs":null,
                     "isPackage":false,
                     "isPackageComponent":false,
                     "packageName":null,
                     "productUrl":"https://en.wikipedia.org/wiki/History_of_Python,,",
                     "lifecycle":{
                        "gaDate":"2010-07-03T00:00:00.000Z",
                        "eolDate":"2020-01-01T00:00:00.000Z",
                        "eosDate":"2020-01-01T00:00:00.000Z",
                        "stage":"EOL/EOS",
                        "lifeCycleConfidence":"Exact",
                        "eolSupportStage":"End-of-life",
                        "eosSupportStage":"End-of-life"
                     },
                     "supportStageDesc":"Python's policy is to drop support major versions once they reach their end of life",
                     "license":{
                        "category":"Open Source",
                        "subcategory":"Python License (Python-2.0)"
                     },
                     "authorization":"Authorized"
                  },
                  {
                     "id":9136542396418607016,
                     "fullName":"OpenBSD OpenSSH Server 7.4p1",
                     "softwareType":"Application",
                     "isIgnored":false,
                     "ignoredReason":null,
                     "category":"Networking / Access Software",
                     "category1":"Networking",
                     "category2":"Access Software",
                     "productName":"OpenSSH",
                     "component":"Server",
                     "publisher":"OpenBSD",
                     "edition":null,
                     "marketVersion":"7",
                     "version":"7.4",
                     "update":"7.4p1",
                     "architecture":null,
                     "installDate":"2020-03-05T14:23:53.000Z",
                     "installPath":null,
                     "lastUpdated":"2020-11-25T12:46:53.000Z",
                     "lastUseDate":null,
                     "language":null,
                     "formerlyKnownAs":"OpenBSD Secure Shell",
                     "isPackage":true,
                     "isPackageComponent":false,
                     "packageName":null,
                     "productUrl":"https://en.wikipedia.org/wiki/OpenSSH,,",
                     "lifecycle":{
                        "gaDate":"2016-12-19T00:00:00.000Z",
                        "eolDate":null,
                        "eosDate":null,
                        "stage":"EOL",
                        "lifeCycleConfidence":"Calculated",
                        "eolSupportStage":" ",
                        "eosSupportStage":" "
                     },
                     "supportStageDesc":null,
                     "license":{
                        "category":"Open Source",
                        "subcategory":"BSD 2-Clause License (FreeBSD/Simplified)"
                     },
                     "authorization":"Authorized"
                  }
               ]
            },
            "provider":null,
            "cloudProvider":null,
            "agent":null,
            "sensor":{
               "activatedForModules":[
                  "VM"
               ],
               "pendingActivationForModules":[
               ],
               "lastVMScan":1606306572000,
               "lastComplianceScan":0,
               "lastFullScan":1606306572000
            },
            "container":null,
            "inventory":{
               "source":"IP",
               "created":1606308565000,
               "lastUpdated":1617703353000
            },
            "activity":null,
            "tagList":{
               "tag":[
                  {
                     "tagId":14151022,
                     "tagName":"static split",
                     "foregroundColor":0,
                     "backgroundColor":-65536,
                     "businessImpact":null,
                     "criticalityScore":2
                  }
               ]
            },
            "serviceList":null,
            "lastLocation":null,
            "criticality":{
               "score":2,
               "isDefault":true,
               "lastUpdated":"2021-06-30T09:43:27.000Z"
            },
            "businessInformation":{
               "company":"Qualys",
               "department":"Engineering",
               "ownedBy":"Paul",
               "environment":"QA",
               "managedBy":"Slimmer",
               "supportedBy":"Nick",
               "supportGroup":"ABC_01",
               "operationalStatus":"Blocked"
            },
            "assignedLocation":{
               "name":"4492 Camino De La Plaza, Pune,IN",
               "city":"Pune",
               "state":"MH",
               "country":"IN"
            },
            "businessAppListData":{
               "businessApp":[
                  {
                     "id":"BARCODE283904",
                     "name":"Quoting App",
                     "environment":"Production",
                     "businessCriticality":"2 - Less Critical",
                     "managedBy":"Slimmer",
                     "ownedBy":"Parick",
                     "supportedBy":"Jhon",
                     "supportGroup":"SME Operations",
                     "operationalStatus":"Mended",
                     "status":"Installed",
                     "usedFor":"Production"
                  },
                  {
                     "id":"BARCODE2839067gfh",
                     "name":"HRA",
                     "environment":"Production",
                     "businessCriticality":"1 - Most Critical",
                     "managedBy":"Slimmer",
                     "ownedBy":"Patrick",
                     "supportedBy":"Jhon",
                     "supportGroup":"SME Operations",
                     "operationalStatus":"broken",
                     "status":"Installed",
                     "usedFor":"Production"
                  }
               ]
            },
            "riskScore":690,
            "passiveSensor":null,
            "asn":"AS27385",
            "isp":"Qualys, Inc.",
            "domain":[
               "qualys.com",
               "qualys.in"
            ],
            "subdomain":[
               "docs.qualys.com",
               "www.qualys.com"
            ],
            "whois":[
               {
                  "domain":"vulnerability-management.com",
                  "createdDate":null,
                  "dnssec":null,
                  "domainStatus":"clientTransferProhibited",
                  "registrantOrganization":"Qualys, Inc.",
                  "registrantName":null,
                  "registrantEmail":"example@domain.com",
                  "registrantContact":null,
                  "registrar":"Gandi SAS",
                  "organizationName":"Qualys, Inc.",
                  "updatedDate":null
               }"missingSoftware":null,
               "customAttributes":[
                  {
                     "key":"Media State4",
                     "value":"Media disconnected",
                     "connectorName":"Qualys"
                  },
                  {
                     "key":"Default Gateway11",
                     "value":"111.111.1.1",
                     "connectorName":"Qualys"
                  },
                  "..."{
                     "key":"Subnet Mask",
                     "value":"222.222.222.0",
                     "connectorName":"Qualys"
                  },
                  "..."
               ],
               "lparId": "6 LXAG-A72TL5-22"
               "processor":null
            }
         ]
      }

Updated API: Get Host Details of All Assets

New or Updated API Updated
API Endpoint /rest/2.0/search/am/asset
Method POST
DTD or XSD changes Not Applicable

Use this API to fetch details of all assets that are associated with the LPAR ID.

Sample: Fetch details of assets with a specific LPAR IDSample: Fetch details of assets with a specific LPAR ID

API Request

curl -X POST
'<qualys_base_url>/rest/2.0/search/am/asset'
-H 'Accept: application/xml'
-H 'Authorization: Bearer <JWTToken>'
-H 'Content-Type: application/json'
-data-raw

Filter in XML

<FilterRequest>
  <filters>
    <Criteria field="asset.lparID" operator="EQUALS">
      <value>6 LXAG-A72TL5-22</value>
    </Criteria>
  </filters>
</FilterRequest>

API Response

{
   "responseMessage":"Valid API Access",
   "responseCode":"SUCCESS",
   "assetListData":{
      "asset":[
         {
            "assetId":60923488,
            "assetUUID":"50d20290-c66a-42e7-8c0a-ba6e92b6324c",
            "hostId":1437386,
            "lastModifiedDate":"2021-04-06T10:02:33.000Z",
            "agentId":null,
            "createdDate":"2020-11-25T12:49:25.000Z",
            "sensorLastUpdatedDate":"2021-04-06T10:02:33.000Z",
            "assetType":"HOST",
            "address":"11.111.111.11",
            "dnsName":"localhost.localdomain",
            "assetName":"localhost.localdomain",
            "netbiosName":null,
            "timeZone":"IST",
            "biosDescription":null,
            "lastBoot":null,
            "totalMemory":5806,
            "cpuCount":null,
            "lastLoggedOnUser":"root",
            "hwUUID":"422a2b16-4c8b-588a-a20c-c1851ad7e376",
            "biosSerialNumber":"VMware-42 2a 2b 16 4c 8b 58 8a-a2 0c c1 85 1a d7 e3 76",
            "biosAssetTag":"No Asset Tag",
            "isContainerHost":false,
            "operatingSystem":{
               "osName":"The CentOS Project CentOS 7 (1810)",
               "fullName":"The CentOS Project CentOS 7 (1810)",
               "category":"Linux / Server",
               "category1":"Linux",
               "category2":"Server",
               "productName":"CentOS",
               "publisher":"The CentOS Project",
               "edition":null,
               "marketVersion":"7",
               "version":"1810",
               "update":null,
               "architecture":null,
               "lifecycle":{
                  "gaDate":"2018-12-03T00:00:00.000Z",
                  "eolDate":"2020-12-31T00:00:00.000Z",
                  "eosDate":"2024-06-30T00:00:00.000Z",
                  "stage":"EOL",
                  "lifeCycleConfidence":"Exact",
                  "eolSupportStage":"Full updates",
                  "eosSupportStage":"Maintenance Updates"
               },
               "taxonomy":{
                  "id":null,
                  "name":"Linux / Server",
                  "category1":"Linux",
                  "category2":"Server"
               },
               "productUrl":"https://www.centos.org/,https://en.wikipedia.org/wiki/CentOS,",
               "productFamily":null,
               "installDate":null,
               "release":"7.4.1708"
            },
            "hardware":{
               "fullName":"VMware VMware Virtual Platform VMware Virtual Platform",
               "category":"Virtualized / Virtual Machine",
               "category1":"Virtualized",
               "category2":"Virtual Machine",
               "manufacturer":"VMware",
               "productName":"VMware Virtual Platform",
               "model":"VMware Virtual Platform",
               "lifecycle":{
                  "introDate":null,
                  "gaDate":null,
                  "eosDate":null,
                  "obsoleteDate":null,
                  "stage":"Unknown",
                  "lifeCycleConfidence":" "
               },
               "taxonomy":{
                  "id":null,
                  "name":"Virtualized / Virtual Machine",
                  "category1":"Virtualized",
                  "category2":"Virtual Machine"
               },
               "productUrl":"https://www.linuxjournal.com/article/3458,,",
               "productFamily":null
            },
            "userAccountListData":null,
            "openPortListData":{
               "openPort":[
                  {
                     "port":709,
                     "description":"",
                     "protocol":"UDP",
                     "detectedService":"portmap/rpcbind",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":50000,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"IBM_DB2_Universal_Database",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":6000,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"x11",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":22,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"ssh",
                     "firstFound":"2020-11-25T12:46:41.000Z",
                     "lastUpdated":"2020-11-25T12:46:41.000Z"
                  },
                  {
                     "port":3389,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":null,
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":111,
                     "description":"",
                     "protocol":"UDP",
                     "detectedService":"rpc_udp",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":111,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"rpc",
                     "firstFound":"2020-11-25T12:46:41.000Z",
                     "lastUpdated":"2020-11-25T12:46:41.000Z"
                  }
               ]
            },
            "volumeListData":{
               "volume":[
                  {
                     "name":"tmpfs",
                     "free":2737078272,
                     "size":3043934208
                  },
                  {
                     "name":"/dev/mapper/centos-home",
                     "free":18629619712,
                     "size":18700304384
                  },
                  {
                     "name":"devtmpfs",
                     "free":3026444288,
                     "size":3026444288
                  },
                  {
                     "name":"/dev/mapper/centos-root",
                     "free":19672580096,
                     "size":38304645120
                  },
                  {
                     "name":"/dev/sda1",
                     "free":876040192,
                     "size":1063256064
                  }
               ]
            },
            "networkInterfaceListData":{
               "networkInterface":[
                  {
                     "hostname":"localhost.localdomain",
                     "addressIpV4":"111.111.111.1",
                     "addressIpV6":null,
                     "macAddress":"11:111:11:e1:71",
                     "interfaceName":"virbr0",
                     "dnsAddress":null,
                     "gatewayAddress":"",
                     "manufacturer":null,
                     "macVendorIntroDate":null,
                     "addresses":null
                  },
                  {
                     "hostname":"localhost.localdomain",
                     "addressIpV4":"11.111.111.11",
                     "addressIpV6":"fe80:0:0:0:250:56ff:feaa:e2da",
                     "macAddress":"00:00:00:aa:e2:da",
                     "interfaceName":"ens192",
                     "dnsAddress":null,
                     "gatewayAddress":"",
                     "manufacturer":"VMware",
                     "macVendorIntroDate":946944000000,
                     "addresses":null
                  }
               ]
            },
            "softwareListData":{
               "software":[
                  {
                     "id":-5698725809391962787,
                     "fullName":"Python 2.7.5 64-Bit",
                     "softwareType":"Application",
                     "isIgnored":false,
                     "ignoredReason":null,
                     "category":"Application Development / Programming Languages",
                     "category1":"Application Development",
                     "category2":"Programming Languages",
                     "productName":"Python",
                     "component":null,
                     "publisher":"Python",
                     "edition":null,
                     "marketVersion":"2",
                     "version":"2.7",
                     "update":"2.7.5",
                     "architecture":"64-Bit",
                     "installDate":"2020-03-27T16:11:47.000Z",
                     "installPath":null,
                     "lastUpdated":"2020-11-25T12:46:46.000Z",
                     "lastUseDate":null,
                     "language":null,
                     "formerlyKnownAs":null,
                     "isPackage":false,
                     "isPackageComponent":false,
                     "packageName":null,
                     "productUrl":"https://en.wikipedia.org/wiki/History_of_Python,,",
                     "lifecycle":{
                        "gaDate":"2010-07-03T00:00:00.000Z",
                        "eolDate":"2020-01-01T00:00:00.000Z",
                        "eosDate":"2020-01-01T00:00:00.000Z",
                        "stage":"EOL/EOS",
                        "lifeCycleConfidence":"Exact",
                        "eolSupportStage":"End-of-life",
                        "eosSupportStage":"End-of-life"
                     },
                     "supportStageDesc":"Python's policy is to drop support major versions once they reach their end of life",
                     "license":{
                        "category":"Open Source",
                        "subcategory":"Python License (Python-2.0)"
                     },
                     "authorization":"Authorized"
                  },
                  {
                     "id":9136542396418607016,
                     "fullName":"OpenBSD OpenSSH Server 7.4p1",
                     "softwareType":"Application",
                     "isIgnored":false,
                     "ignoredReason":null,
                     "category":"Networking / Access Software",
                     "category1":"Networking",
                     "category2":"Access Software",
                     "productName":"OpenSSH",
                     "component":"Server",
                     "publisher":"OpenBSD",
                     "edition":null,
                     "marketVersion":"7",
                     "version":"7.4",
                     "update":"7.4p1",
                     "architecture":null,
                     "installDate":"2020-03-05T14:23:53.000Z",
                     "installPath":null,
                     "lastUpdated":"2020-11-25T12:46:53.000Z",
                     "lastUseDate":null,
                     "language":null,
                     "formerlyKnownAs":"OpenBSD Secure Shell",
                     "isPackage":true,
                     "isPackageComponent":false,
                     "packageName":null,
                     "productUrl":"https://en.wikipedia.org/wiki/OpenSSH,,",
                     "lifecycle":{
                        "gaDate":"2016-12-19T00:00:00.000Z",
                        "eolDate":null,
                        "eosDate":null,
                        "stage":"EOL",
                        "lifeCycleConfidence":"Calculated",
                        "eolSupportStage":" ",
                        "eosSupportStage":" "
                     },
                     "supportStageDesc":null,
                     "license":{
                        "category":"Open Source",
                        "subcategory":"BSD 2-Clause License (FreeBSD/Simplified)"
                     },
                     "authorization":"Authorized"
                  }
               ]
            },
            "provider":null,
            "cloudProvider":null,
            "agent":null,
            "sensor":{
               "activatedForModules":[
                  "VM"
               ],
               "pendingActivationForModules":[
               ],
               "lastVMScan":1606306572000,
               "lastComplianceScan":0,
               "lastFullScan":1606306572000
            },
            "container":null,
            "inventory":{
               "source":"IP",
               "created":1606308565000,
               "lastUpdated":1617703353000
            },
            "activity":null,
            "tagList":{
               "tag":[
                  {
                     "tagId":14151022,
                     "tagName":"static split",
                     "foregroundColor":0,
                     "backgroundColor":-65536,
                     "businessImpact":null,
                     "criticalityScore":2
                  }
               ]
            },
            "serviceList":null,
            "lastLocation":null,
            "criticality":{
               "score":2,
               "isDefault":true,
               "lastUpdated":"2021-06-30T09:43:27.000Z"
            },
            "businessInformation":{
               "company":"Qualys",
               "department":"Engineering",
               "ownedBy":"Paul",
               "environment":"QA",
               "managedBy":"Slimmer",
               "supportedBy":"Nick",
               "supportGroup":"ABC_01",
               "operationalStatus":"Blocked"
            },
            "assignedLocation":{
               "name":"4492 Camino De La Plaza, Pune,IN",
               "city":"Pune",
               "state":"MH",
               "country":"IN"
            },
            "businessAppListData":{
               "businessApp":[
                  {
                     "id":"BARCODE283904",
                     "name":"Quoting App",
                     "environment":"Production",
                     "businessCriticality":"2 - Less Critical",
                     "managedBy":"Slimmer",
                     "ownedBy":"Parick",
                     "supportedBy":"Jhon",
                     "supportGroup":"SME Operations",
                     "operationalStatus":"Mended",
                     "status":"Installed",
                     "usedFor":"Production"
                  },
                  {
                     "id":"BARCODE2839067gfh",
                     "name":"HRA",
                     "environment":"Production",
                     "businessCriticality":"1 - Most Critical",
                     "managedBy":"Slimmer",
                     "ownedBy":"Patrick",
                     "supportedBy":"Jhon",
                     "supportGroup":"SME Operations",
                     "operationalStatus":"broken",
                     "status":"Installed",
                     "usedFor":"Production"
                  }
               ]
            },
            "riskScore":690,
            "passiveSensor":null,
            "asn":"AS27385",
            "isp":"Qualys, Inc.",
            "domain":[
               "qualys.com",
               "qualys.in"
            ],
            "subdomain":[
               "docs.qualys.com",
               "www.qualys.com"
            ],
            "whois":[
               {
                  "domain":"vulnerability-management.com",
                  "createdDate":null,
                  "dnssec":null,
                  "domainStatus":"clientTransferProhibited",
                  "registrantOrganization":"Qualys, Inc.",
                  "registrantName":null,
                  "registrantEmail":"example@domain.com",
                  "registrantContact":null,
                  "registrar":"Gandi SAS",
                  "organizationName":"Qualys, Inc.",
                  "updatedDate":null
               }"missingSoftware":null,
               "customAttributes":[
                  {
                     "key":"Media State4",
                     "value":"Media disconnected",
                     "connectorName":"Qualys"
                  },
                  {
                     "key":"Default Gateway11",
                     "value":"111.111.1.1",
                     "connectorName":"Qualys"
                  },
                  "..."{
                     "key":"Subnet Mask",
                     "value":"222.222.222.0",
                     "connectorName":"Qualys"
                  },
                  "..."
               ],
               "lparId": "6 LXAG-A72TL5-22"
               "processor":null
            }
         ]
      }

Updated API: Get Count of Assets

New or Updated API Updated
API Endpoint /rest/2.0/count/am/asset
Method POST
DTD or XSD changes Not Applicable

Use this API to fetch the total number of assets associated with the specified LPAR ID.

Sample: Fetch the total number of assets associated with the specified LPAR IDSample: Fetch the total number of assets associated with the specified LPAR ID

API Request

curl -X POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data-raw

Filter in XML

<FilterRequest>
  <filters>
    <Criteria field="asset.lparID" operator="EQUALS">
      <value>6 LXAG-A72TL5-22</value>
    </Criteria>
  </filters>
</FilterRequest>

API Response

{
"count":1,
"responseCode":"SUCCESS",
"responseMessage":"Valid API Access"
}

Updated API: List Asset Host Details based on Filter

New or Updated API Updated
API Endpoint am/v1/assets/host/filter/list
Method POST
DTD or XSD changes Not Applicable

Use this API to fetch details of asset that is associated with the LPAR ID.

Sample: Fetch details of asset that is associated with the specified LPAR IDSample: Fetch details of asset that is associated with the specified LPAR ID

API Request

curl -X POST
'<qualys_base_url>/am/v1/assets/host/filter/list?filter=asset.lparID=6 LXAG-A72TL5'
-H 'Authorization: Bearer <JWT Token>'
-H 'Content-Type: application/json'

API Response

{
   "responseMessage":"Valid API Access",
   "responseCode":"SUCCESS",
   "assetListData":{
      "asset":[
         {
            "assetId":60923488,
            "assetUUID":"50d20290-c66a-42e7-8c0a-ba6e92b6324c",
            "hostId":1437386,
            "lastModifiedDate":"2021-04-06T10:02:33.000Z",
            "agentId":null,
            "createdDate":"2020-11-25T12:49:25.000Z",
            "sensorLastUpdatedDate":"2021-04-06T10:02:33.000Z",
            "assetType":"HOST",
            "address":"10.115.110.95",
            "dnsName":"localhost.localdomain",
            "assetName":"localhost.localdomain",
            "netbiosName":null,
            "timeZone":"IST",
            "biosDescription":null,
            "lastBoot":null,
            "totalMemory":5806,
            "cpuCount":null,
            "lastLoggedOnUser":"root",
            "hwUUID":"422a2b16-4c8b-588a-a20c-c1851ad7e376",
            "biosSerialNumber":"VMware-42 2a 2b 16 4c 8b 58 8a-a2 0c c1 85 1a d7 e3 76",
            "biosAssetTag":"No Asset Tag",
            "isContainerHost":false,
            "operatingSystem":{
               "osName":"The CentOS Project CentOS 7 (1810)",
               "fullName":"The CentOS Project CentOS 7 (1810)",
               "category":"Linux / Server",
               "category1":"Linux",
               "category2":"Server",
               "productName":"CentOS",
               "publisher":"The CentOS Project",
               "edition":null,
               "marketVersion":"7",
               "version":"1810",
               "update":null,
               "architecture":null,
               "lifecycle":{
                  "gaDate":"2018-12-03T00:00:00.000Z",
                  "eolDate":"2020-12-31T00:00:00.000Z",
                  "eosDate":"2024-06-30T00:00:00.000Z",
                  "stage":"EOL",
                  "lifeCycleConfidence":"Exact",
                  "eolSupportStage":"Full updates",
                  "eosSupportStage":"Maintenance Updates"
               },
               "taxonomy":{
                  "id":null,
                  "name":"Linux / Server",
                  "category1":"Linux",
                  "category2":"Server"
               },
               "productUrl":"https://www.centos.org/,https://en.wikipedia.org/wiki/CentOS,",
               "productFamily":null,
               "installDate":null,
               "release":"7.4.1708"
            },
            "hardware":{
               "fullName":"VMware VMware Virtual Platform VMware Virtual Platform",
               "category":"Virtualized / Virtual Machine",
               "category1":"Virtualized",
               "category2":"Virtual Machine",
               "manufacturer":"VMware",
               "productName":"VMware Virtual Platform",
               "model":"VMware Virtual Platform",
               "lifecycle":{
                  "introDate":null,
                  "gaDate":null,
                  "eosDate":null,
                  "obsoleteDate":null,
                  "stage":"Unknown",
                  "lifeCycleConfidence":" "
               },
               "taxonomy":{
                  "id":null,
                  "name":"Virtualized / Virtual Machine",
                  "category1":"Virtualized",
                  "category2":"Virtual Machine"
               },
               "productUrl":"https://www.linuxjournal.com/article/3458,,",
               "productFamily":null
            },
            "userAccountListData":null,
            "openPortListData":{
               "openPort":[
                  {
                     "port":709,
                     "description":"",
                     "protocol":"UDP",
                     "detectedService":"portmap/rpcbind",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":50000,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"IBM_DB2_Universal_Database",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":6000,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"x11",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":22,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"ssh",
                     "firstFound":"2020-11-25T12:46:41.000Z",
                     "lastUpdated":"2020-11-25T12:46:41.000Z"
                  },
                  {
                     "port":3389,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":null,
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":111,
                     "description":"",
                     "protocol":"UDP",
                     "detectedService":"rpc_udp",
                     "firstFound":"2020-11-25T12:46:42.000Z",
                     "lastUpdated":"2020-11-25T12:46:42.000Z"
                  },
                  {
                     "port":111,
                     "description":"",
                     "protocol":"TCP",
                     "detectedService":"rpc",
                     "firstFound":"2020-11-25T12:46:41.000Z",
                     "lastUpdated":"2020-11-25T12:46:41.000Z"
                  }
               ]
            },
            "volumeListData":{
               "volume":[
                  {
                     "name":"tmpfs",
                     "free":2737078272,
                     "size":3043934208
                  },
                  {
                     "name":"/dev/mapper/centos-home",
                     "free":18629619712,
                     "size":18700304384
                  },
                  {
                     "name":"devtmpfs",
                     "free":3026444288,
                     "size":3026444288
                  },
                  {
                     "name":"/dev/mapper/centos-root",
                     "free":19672580096,
                     "size":38304645120
                  },
                  {
                     "name":"/dev/sda1",
                     "free":876040192,
                     "size":1063256064
                  }
               ]
            },
            "networkInterfaceListData":{
               "networkInterface":[
                  {
                     "hostname":"localhost.localdomain",
                     "addressIpV4":"192.168.122.1",
                     "addressIpV6":null,
                     "macAddress":"52:54:00:77:e1:71",
                     "interfaceName":"virbr0",
                     "dnsAddress":null,
                     "gatewayAddress":"",
                     "manufacturer":null,
                     "macVendorIntroDate":null,
                     "addresses":null
                  },
                  {
                     "hostname":"localhost.localdomain",
                     "addressIpV4":"10.115.110.95",
                     "addressIpV6":"fe80:0:0:0:250:56ff:feaa:e2da",
                     "macAddress":"00:50:56:aa:e2:da",
                     "interfaceName":"ens192",
                     "dnsAddress":null,
                     "gatewayAddress":"",
                     "manufacturer":"VMware",
                     "macVendorIntroDate":946944000000,
                     "addresses":null
                  }
               ]
            },
            "softwareListData":{
               "software":[
                  {
                     "id":-5698725809391962787,
                     "fullName":"Python 2.7.5 64-Bit",
                     "softwareType":"Application",
                     "isIgnored":false,
                     "ignoredReason":null,
                     "category":"Application Development / Programming Languages",
                     "category1":"Application Development",
                     "category2":"Programming Languages",
                     "productName":"Python",
                     "component":null,
                     "publisher":"Python",
                     "edition":null,
                     "marketVersion":"2",
                     "version":"2.7",
                     "update":"2.7.5",
                     "architecture":"64-Bit",
                     "installDate":"2020-03-27T16:11:47.000Z",
                     "installPath":null,
                     "lastUpdated":"2020-11-25T12:46:46.000Z",
                     "lastUseDate":null,
                     "language":null,
                     "formerlyKnownAs":null,
                     "isPackage":false,
                     "isPackageComponent":false,
                     "packageName":null,
                     "productUrl":"https://en.wikipedia.org/wiki/History_of_Python,,",
                     "lifecycle":{
                        "gaDate":"2010-07-03T00:00:00.000Z",
                        "eolDate":"2020-01-01T00:00:00.000Z",
                        "eosDate":"2020-01-01T00:00:00.000Z",
                        "stage":"EOL/EOS",
                        "lifeCycleConfidence":"Exact",
                        "eolSupportStage":"End-of-life",
                        "eosSupportStage":"End-of-life"
                     },
                     "supportStageDesc":"Python's policy is to drop support major versions once they reach their end of life",
                     "license":{
                        "category":"Open Source",
                        "subcategory":"Python License (Python-2.0)"
                     },
                     "authorization":"Authorized"
                  },
                  {
                     "id":9136542396418607016,
                     "fullName":"OpenBSD OpenSSH Server 7.4p1",
                     "softwareType":"Application",
                     "isIgnored":false,
                     "ignoredReason":null,
                     "category":"Networking / Access Software",
                     "category1":"Networking",
                     "category2":"Access Software",
                     "productName":"OpenSSH",
                     "component":"Server",
                     "publisher":"OpenBSD",
                     "edition":null,
                     "marketVersion":"7",
                     "version":"7.4",
                     "update":"7.4p1",
                     "architecture":null,
                     "installDate":"2020-03-05T14:23:53.000Z",
                     "installPath":null,
                     "lastUpdated":"2020-11-25T12:46:53.000Z",
                     "lastUseDate":null,
                     "language":null,
                     "formerlyKnownAs":"OpenBSD Secure Shell",
                     "isPackage":true,
                     "isPackageComponent":false,
                     "packageName":null,
                     "productUrl":"https://en.wikipedia.org/wiki/OpenSSH,,",
                     "lifecycle":{
                        "gaDate":"2016-12-19T00:00:00.000Z",
                        "eolDate":null,
                        "eosDate":null,
                        "stage":"EOL",
                        "lifeCycleConfidence":"Calculated",
                        "eolSupportStage":" ",
                        "eosSupportStage":" "
                     },
                     "supportStageDesc":null,
                     "license":{
                        "category":"Open Source",
                        "subcategory":"BSD 2-Clause License (FreeBSD/Simplified)"
                     },
                     "authorization":"Authorized"
                  }
               ]
            },
            "provider":null,
            "cloudProvider":null,
            "agent":null,
            "sensor":{
               "activatedForModules":[
                  "VM"
               ],
               "pendingActivationForModules":[
               ],
               "lastVMScan":1606306572000,
               "lastComplianceScan":0,
               "lastFullScan":1606306572000
            },
            "container":null,
            "inventory":{
               "source":"IP",
               "created":1606308565000,
               "lastUpdated":1617703353000
            },
            "activity":null,
            "tagList":{
               "tag":[
                  {
                     "tagId":14151022,
                     "tagName":"static split",
                     "foregroundColor":0,
                     "backgroundColor":-65536,
                     "businessImpact":null,
                     "criticalityScore":2
                  }
               ]
            },
            "serviceList":null,
            "lastLocation":null,
            "criticality":{
               "score":2,
               "isDefault":true,
               "lastUpdated":"2021-06-30T09:43:27.000Z"
            },
            "businessInformation":{
               "company":"Qualys",
               "department":"Engineering",
               "ownedBy":"Paul",
               "environment":"QA",
               "managedBy":"Amit",
               "supportedBy":"Nick",
               "supportGroup":"ABC_01",
               "operationalStatus":"Blocked"
            },
            "assignedLocation":{
               "name":"4492 Camino De La Plaza, Pune,IN",
               "city":"Pune",
               "state":"MH",
               "country":"IN"
            },
            "businessAppListData":{
               "businessApp":[
                  {
                     "id":"BARCODE283904",
                     "name":"Quoting App",
                     "environment":"Production",
                     "businessCriticality":"2 - Less Critical",
                     "managedBy":"Amit",
                     "ownedBy":"Narendra",
                     "supportedBy":"Rishabh",
                     "supportGroup":"SME Operations",
                     "operationalStatus":"Mended",
                     "status":"Installed",
                     "usedFor":"Production"
                  },
                  {
                     "id":"BARCODE2839067gfh",
                     "name":"HRA",
                     "environment":"Production",
                     "businessCriticality":"1 - Most Critical",
                     "managedBy":"Amit",
                     "ownedBy":"Narendra",
                     "supportedBy":"Rishabh",
                     "supportGroup":"SME Operations",
                     "operationalStatus":"broken",
                     "status":"Installed",
                     "usedFor":"Production"
                  }
               ]
            },
            "riskScore":690,
            "passiveSensor":null,
            "asn":"AS27385",
            "isp":"Qualys, Inc.",
            "domain":[
               "qualys.com",
               "qualys.in"
            ],
            "subdomain":[
               "docs.qualys.com",
               "www.qualys.com"
            ],
            "whois":[
               {
                  "domain":"vulnerability-management.com",
                  "createdDate":null,
                  "dnssec":null,
                  "domainStatus":"clientTransferProhibited",
                  "registrantOrganization":"Qualys, Inc.",
                  "registrantName":null,
                  "registrantEmail":"6d229c2ef8870a654745766aab8e6ace-49101@contact.gandi.net",
                  "registrantContact":null,
                  "registrar":"Gandi SAS",
                  "organizationName":"Qualys, Inc.",
                  "updatedDate":null
               }"missingSoftware":null,
               "customAttributes":[
                  {
                     "key":"Media State4",
                     "value":"Media disconnected",
                     "connectorName":"Qualys"
                  },
                  {
                     "key":"Default Gateway11",
                     "value":"192.168.1.1",
                     "connectorName":"Qualys"
                  },
                  "..."{
                     "key":"Subnet Mask",
                     "value":"255.255.255.0",
                     "connectorName":"Qualys"
                  },
                  "..."
               ],
               "lparId": "6 LXAG-A72TL5-22"
               "processor":null
            }
         ]
      }

Support for Filtering Domains by Registrant Country and Expiration Date

With this release, we have enhanced the Asset and Domain APIs that allows you to filter the response based on the domain registered country and their expiration date. 

We have introduced the following two new filtering parameters to support this enhancement: 

Filtering Parameter Mandatory
/Optional
Data Type Supported Operator Description
whoIs.
registrant
Country
Optional String - CONTAINS

- IN

- EQUALS

- NOT_EQUALS

Fetch domains based on the registrant’s country. 
whoIs.
expiration
Date
Optional String - EQUALS

- NOT_EQUALS

- GREATER

- LESSER

- GREATER_THAN
   _EQUAL

- LESS_THAN
   _EQUAL

Fetch domains based on the expiration date.

The following APIs are impacted due to the enhancement:

Updated API: Get the Count of Unresolved Domains

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 get the total count of the unresolved domains based on the whoIs.registrantCountry and whoIs.expirationDate filters.

Sample: Get total count of unresolved domains within the provided filtersSample: Get total count of unresolved domains within the provided filters

API Request

curl -X POST
'<qualys_base_url>/rest/2.0/am/domain/count'
--header 'Content-Type: application/xml'
--header 'Authorization: <JWT Token>'
--data

Filter in XML

<FilterRequest>
    <filters>
        <Criteria field="whoIs.registrantCountry" operator="EQUALS">
            <value>FRANCE</value>
        </Criteria>
        <Criteria field="whoIs.expirationDate" operator="EQUALS">
            <value>2026-02-22</value>
        </Criteria>
    </filters>
    <operation>AND</operation>
</FilterRequest>'

API Response

 {
    "count": 1,
    "responseCode": "SUCCESS",
    "responseMessage": "Valid API Access"
}

Updated API: Get a List of Unresolved Domains

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 get the details of unresolved domains based on the whoIs.registrantCountry and whoIs.expirationDate filters.

Sample: Get details of unresolved domains within the provided filtersSample: Get details of unresolved domains within the provided filters

API Request with filter in XML

curl -X POST
'<qualys_base_url>/rest/2.0/am/domain/list'
--header 'Content-Type: application/xml'
--header 'Authorization: <JWT token>'
--data '<FilterRequest>
    <filters>
        <Criteria field="whoIs.registrantCountry" operator="IN">
            <value>FRANCE</value>
        </Criteria>
        <Criteria field="whoIs.expirationDate" operator="EQUALS">
            <value>2026-02-22</value>
        </Criteria>
    </filters>
    <operation>AND</operation>
</FilterRequest>'

API Request with filter in JSON

 curl -X POST
'<qualys_base_url>/rest/2.0/am/domain/list'
--header 'Content-Type: application/json'
--header 'Authorization: <JWT token>'
--data '{
  "filters": [
    {
      "filters": [
        {
          "value": "FRANCE",
          "field": "whoIs.registrantCountry",
          "operator": "EQUALS"
        },
        {
          "value": "2026-02-22",
          "field": "whoIs.expirationDate",
          "operator": "EQUALS"
        }
      ],
      "operation": "AND"
    }
  ]
}'

API Response

{
  "responseMessage": "Valid API Access",
  "responseCode": "SUCCESS",
  "hasMore": 0,
  "count": 64,
  "lastFetchDomainId": 2122005886,
  "domainListData": {
    "domains": [
      {
        "domain": "example.com",
        "subdomain": "sub.example.com",
        "whoIs": {
          "registrar": "Dummy Registrar Inc.",
          "registrantOrg": "Example Organization",
          "registrantEmailId": "contact@example.com",
          "creationDate": "2010-01-01",
          "registrantCountry": "FRANCE",
          "expirationDate": "2026-02-22"
        }
      }
    ]
  }
}

Updated API: Get Count of Assets

New or Updated API Updated
API Endpoint /rest/2.0/count/am/asset
Method POST
DTD or XSD changes Not Applicable

Use this API to fetch the total number of domains based on the whoIs.registrantCountry and whoIs.expirationDate filters.

Sample: Fetch the total number of domains within the provided filterSample: Fetch the total number of domains within the provided filter

API Request

curl -X POST
'<qualys_base_url>/rest/2.0/count/am/asset'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/xml'
--data-raw

Filter in XML

<FilterRequest>
    <filters>
        <Criteria field="whoIs.registrantCountry" operator="EQUALS">
            <value>FRANCE</value>
        </Criteria>
        <Criteria field="whoIs.expirationDate" operator="EQUALS">
            <value>2026-02-22</value>
        </Criteria>
    </filters>
    <operation>AND</operation>
</FilterRequest>

API Response

{
"count":1,
"responseCode":"SUCCESS",
"responseMessage":"Valid API Access"
}

Updated API: Get Host Details of Specific Asset

New or Updated API Updated
API Endpoint /rest/2.0/get/am/asset
Method GET
DTD or XSD changes Not Applicable

Use this API to fetch the domain details associated with the specified asset ID. The domain details now include the country of the registrant and the expiration date of the domain.

Sample: Fetch the domain details using asset IDSample: Fetch the domain details using asset ID

API Request

curl -X GET
'<qualys_base_url>/rest/2.0/get/am/asset?assetId=50899050'
--header 'Authorization: Bearer <JWT Token>'
--header 'Content-Type: application/json'
--data-raw

API Response

{
    "responseMessage": "Valid API Access",
    "count": 1,
    "responseCode": "SUCCESS",
    "lastSeenAssetId": null,
    "hasMore": 0,
    "assetListData": {
        "asset": [
            {
                "assetId": 50899050,
                "assetUUID": "9b62500d-2f1d-41e0-9bd5-2b90bb840d66",
                "hostId": 1118597111841,
                "lastModifiedDate": "2025-04-12T13:51:37.000Z",
                "agentId": null,
                "createdDate": "2024-11-18T06:52:22.000Z",
                "sensorLastUpdatedDate": "2025-04-12T13:51:37.000Z",
                "assetType": "HOST",
                "address": "169.62.90.147",
                "dnsName": null,
                "assetName": "169.62.90.147",
                "netbiosName": null,
                "timeZone": null,
                "biosDescription": null,
                "lastBoot": null,
                "totalMemory": 0,
                "cpuCount": 0,
                "lastLoggedOnUser": null,
                "domainRole": null,
                "hwUUID": "7e43a4b0-75d6-40dd-80fe-6bbd26176c4e",
                "biosSerialNumber": "2197A8W",
                "biosAssetTag": "",
                "isContainerHost": false,
                "operatingSystem": {
                    "osName": "AIX 7.1",
                    "fullName": "IBM AIX 7.1",
                    "category": "Unix / Server",
                    "category1": "Unix",
                    "category2": "Server",
                    "productName": "AIX",
                    "publisher": "IBM",
                    "edition": null,
                    "marketVersion": "7",
                    "version": "7.1",
                    "update": "7.1",
                    "architecture": null,
                    "lifecycle": {
                        "gaDate": "2010-09-10T00:00:00.000Z",
                        "eolDate": "2022-04-30T00:00:00.000Z",
                        "eosDate": "2022-04-30T00:00:00.000Z",
                        "stage": "EOL/EOS",
                        "lifeCycleConfidence": "Exact",
                        "eolSupportStage": "Service Pack Support",
                        "eosSupportStage": "Service Pack Support",
                        "detectionScore": 40
                    },
                    "taxonomy": {
                        "id": null,
                        "name": "Unix / Server",
                        "category1": "Unix",
                        "category2": "Server"
                    },
                    "productUrl": "https://www.ibm.com/in-en/it-infrastructure/power/os/aix,https://en.wikipedia.org/wiki/IBM_AIX,https://www-01.ibm.com/support/docview.wss?uid=isg1SSRVPOAIX72TIPS171103-0829",
                    "productFamily": null,
                    "installDate": null,
                    "release": "7.1",
                    "cpeId": null,
                    "cpe": null,
                    "cpeType": null
                },
                "hardware": {
                    "fullName": "IBM Power System S824 8286-42A",
                    "category": "Computers / Server",
                    "category1": "Computers",
                    "category2": "Server",
                    "manufacturer": "IBM",
                    "productName": "Power System S824",
                    "model": "8286-42A",
                    "lifecycle": {
                        "introDate": null,
                        "gaDate": "2014-06-10T00:00:00.000Z",
                        "eosDate": "2019-02-28T00:00:00.000Z",
                        "obsoleteDate": "2024-03-31T00:00:00.000Z",
                        "stage": "OBS",
                        "lifeCycleConfidence": "Exact"
                    },
                    "taxonomy": {
                        "id": null,
                        "name": "Computers / Server",
                        "category1": "Computers",
                        "category2": "Server"
                    },
                    "productUrl": "http://www-01.ibm.com/common/ssi/ShowDoc.wss?docURL=/common/ssi/rep_sm/2/760/ENUS8286-_h02/index.html&lang=en&request_locale=en,,",
                    "productFamily": null
                },
                "userAccountListData": {
                    "userAccount": [
                        {
                            "name": "utbdna"
                        },
                        {
                            "name": "oraoam"
                        },
                        {
                            "name": "giani"
                        },
                        {
                            "name": "sshd"
                        },
                        {
                            "name": "venturi"
                        },
                        {
                            "name": "gianini"
                        },
                        {
                            "name": "snapp"
                        },
                        {
                            "name": "mollica"
                        },
                        {
                            "name": "oraoid"
                        },
                        {
                            "name": "stocco"
                        },
                        {
                            "name": "esaadmin"
                        },
                        {
                            "name": "ipsec"
                        },
                        {
                            "name": "lpar2rrd"
                        },
                        {
                            "name": "dradmin"
                        },
                        {
                            "name": "renzi"
                        },
                        {
                            "name": "nuucp"
                        },
                        {
                            "name": "srvproxy"
                        },
                        {
                            "name": "galetti"
                        },
                        {
                            "name": "cappello"
                        },
                        {
                            "name": "oraohs"
                        },
                        {
                            "name": "carcioff"
                        },
                        {
                            "name": "takacs"
                        },
                        {
                            "name": "invscout"
                        },
                        {
                            "name": "ansible"
                        },
                        {
                            "name": "oraagent"
                        },
                        {
                            "name": "taglia"
                        },
                        {
                            "name": "giovinazzo"
                        },
                        {
                            "name": "root"
                        },
                        {
                            "name": "qualys"
                        },
                        {
                            "name": "pconsole"
                        }
                    ]
                },
                "openPortListData": {
                    "openPort": [
                        {
                            "port": 443,
                            "description": "http protocol over TLS/SSL",
                            "protocol": "TCP",
                            "detectedService": "HTTPs",
                            "firstFound": "2025-04-09T12:38:00.000Z",
                            "lastUpdated": "2025-04-09T12:38:00.000Z",
                            "authorization": null,
                            "detectionScore": null,
                            "discoverySources": "EASM"
                        }
                    ]
                },
                "volumeListData": {
                    "volume": [
                        {
                            "name": "/dev/hd2",
                            "free": 16777216,
                            "size": 13474024
                        },
                        {
                            "name": "/dev/hd1",
                            "free": 2097152,
                            "size": 1637680
                        },
                        {
                            "name": "/dev/hd10opt",
                            "free": 2097152,
                            "size": 1394608
                        },
                        {
                            "name": "/dev/hd4",
                            "free": 1048576,
                            "size": 270848
                        },
                        {
                            "name": "/dev/unipollv",
                            "free": 2097152,
                            "size": 1362760
                        },
                        {
                            "name": "/dev/hd3",
                            "free": 6291456,
                            "size": 3810200
                        },
                        {
                            "name": "/dev/u01lv",
                            "free": 77594624,
                            "size": 66261416
                        },
                        {
                            "name": "/dev/hd11admin",
                            "free": 262144,
                            "size": 760
                        },
                        {
                            "name": "/dev/productlv",
                            "free": 3145728,
                            "size": 2252720
                        },
                        {
                            "name": "/dev/hd9var",
                            "free": 2097152,
                            "size": 1374640
                        },
                        {
                            "name": "/dev/livedump",
                            "free": 524288,
                            "size": 736
                        }
                    ]
                },
                "networkInterfaceListData": {
                    "networkInterface": [
                        {
                            "hostname": null,
                            "addressIpV4": "169.62.90.147",
                            "addressIpV6": null,
                            "macAddress": "01:00:5e:00:00:01",
                            "interfaceName": "en0",
                            "dnsAddress": null,
                            "gatewayAddress": "",
                            "manufacturer": null,
                            "macVendorIntroDate": null,
                            "netmask": "255.255.255.0",
                            "addresses": null
                        },
                        {
                            "hostname": null,
                            "addressIpV4": "64.39.96.133",
                            "addressIpV6": null,
                            "macAddress": "01:00:5e:00:00:01",
                            "interfaceName": "en1",
                            "dnsAddress": null,
                            "gatewayAddress": "",
                            "manufacturer": null,
                            "macVendorIntroDate": null,
                            "netmask": "255.255.255.0",
                            "addresses": null
                        },
                        {
                            "hostname": null,
                            "addressIpV4": "172.30.72.113",
                            "addressIpV6": null,
                            "macAddress": "",
                            "interfaceName": "lo0",
                            "dnsAddress": null,
                            "gatewayAddress": "",
                            "manufacturer": null,
                            "macVendorIntroDate": null,
                            "netmask": "255.255.255.0",
                            "addresses": null
                        }
                    ]
                },
                "softwareListData": {
                    "software": [
                        {
                            "id": -4289165170931091461,
                            "discoverySources": "EASM",
                            "fullName": "F5 Nginx Server",
                            "softwareType": "Application",
                            "isIgnored": false,
                            "ignoredReason": null,
                            "category": "Network Application / Web Servers",
                            "category1": "Network Application",
                            "category2": "Web Servers",
                            "productName": "Nginx",
                            "component": "Server",
                            "publisher": "F5",
                            "edition": "Unknown",
                            "marketVersion": "Unknown",
                            "version": null,
                            "update": null,
                            "architecture": null,
                            "installDate": null,
                            "installPath": null,
                            "lastUpdated": null,
                            "lastUseDate": null,
                            "language": null,
                            "formerlyKnownAs": null,
                            "isPackage": false,
                            "isPackageComponent": false,
                            "packageName": null,
                            "productUrl": "http://nginx.org/en/download.html,,",
                            "lifecycle": {
                                "gaDate": null,
                                "eolDate": null,
                                "eosDate": null,
                                "stage": "Not Applicable",
                                "lifeCycleConfidence": "Exact",
                                "eolSupportStage": " ",
                                "eosSupportStage": " ",
                                "detectionScore": 6
                            },
                            "supportStageDesc": null,
                            "license": {
                                "category": "Open Source",
                                "subcategory": "BSD 2-Clause License (FreeBSD/Simplified)"
                            },
                            "authorization": null,
                            "discoveredPublisher": null,
                            "discoveredName": "nginx",
                            "discoveredVersion": null,
                            "authorizationDetectionScore": null,
                            "cpeId": null,
                            "cpe": null,
                            "cpeType": null,
                            "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": 1744465884000,
                    "lastEasmScanDate": 1744465884000
                },
                "container": {
                    "product": null,
                    "version": null,
                    "noOfContainers": 0,
                    "noOfImages": 0,
                    "hasSensor": null
                },
                "inventory": {
                    "source": "IP",
                    "created": 1731912742000,
                    "lastUpdated": 1744465897000
                },
                "activity": {
                    "source": "IP",
                    "lastScannedDate": 1744465897000
                },
                "tagList": {
                    "tag": [
                        {
                            "tagId": 39233480,
                            "tagName": "qq",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                        {
                            "tagId": 30167164,
                            "tagName": "Internet Facing Assets",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                        {
                            "tagId": 30145871,
                            "tagName": "Shodan",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                        {
                            "tagId": 30145870,
                            "tagName": "EASM",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                        {
                            "tagId": 42004579,
                            "tagName": "new_ip",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                        {
                            "tagId": 30145875,
                            "tagName": "EASM Confidence High",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                        {
                            "tagId": 42103897,
                            "tagName": "QDomain",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        }
                    ]
                },
                "serviceList": {
                    "service": []
                },
                "lastLocation": {
                    "city": null,
                    "state": null,
                    "country": "United States",
                    "name": "United States",
                    "continent": "North America",
                    "postal": null
                },
                "criticality": {
                    "score": 3,
                    "isDefault": false,
                    "lastUpdated": "2025-03-31T01:05:20.000Z"
                },
                "businessInformation": null,
                "assignedLocation": null,
                "businessAppListData": null,
                "riskScore": 606,
                "passiveSensor": null,
                "domain": [
                    "qualys.in",
                    "transformsecurity.com",
                    "layeredinsight.com",
                    "qualys.fr",
                    "qualys.tw",
                    "qualys.com.au",
                    "qualys.tv",
                    "qualys.hosting",
                    "csoblog.net",
                    "qualys.asia",
                    "qualysguard.tw",
                    "qualys.ae",
                    "qualys.us",
                    "qualysguard.in",
                    "qualys.at",
                    "qualys.io",
                    "qualys.cloud",
                    "qualys.report",
                    "qualys.mx",
                    "qualys.co.uk",
                    "qualys.services",
                    "qualys.biz",
                    "qualysguard.com",
                    "qualys.com",
                    "qualysguard.asia",
                    "nemeannetworks.com",
                    "qualys.eu",
                    "qualys.it",
                    "nemeannetworks.net"
                ],
                "subdomain": [
                    "partners.qualys.com",
                    "www.qualys.com",
                    "lp.qualys.com",
                    "support.qualys.com",
                    "corp.qualys.com",
                    "corpweb.sc4.qualys.com",
                    "www.corp.qualys.com",
                    "whatview.qualys.com",
                    "docs.qualys.com",
                    "www.cn.qualys.com",
                    "cp.qualys.com",
                    "cn.qualys.com",
                    "events.qualys.com",
                    "www.qualys.eu",
                    "fr1.qualys.com"
                ],
                "missingSoftware": [],
                "whois": [
                    {
                        "domain": "qualys.tv",
                        "createdDate": "2018-09-12T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor, Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor, Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-09-12T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualysguard.in",
                        "createdDate": "2009-02-23T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientUpdateProhibited clientTransferProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-23T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.tw",
                        "createdDate": "2009-02-25T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientUpdateProhibited,clientTransferProhibited,clientDeleteProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "Markmonitor, Inc.|Registration Service URL: http://www.markmonitor.com/|Provided by Registry Services, LLC. Registry Gateway Services",
                        "registrantEmail": "domain-admin@qualys.com",
                        "registrantContact": null,
                        "registrar": "Markmonitor, Inc.|Registration Service URL: http://www.markmonitor.com/|Provided by Registry Services, LLC. Registry Gateway Services",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-25T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.com.au",
                        "createdDate": null,
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited https://identitydigital.au/get-au/whois-status-codes#clientDeleteProhibited|serverRenewProhibited https://identitydigital.au/get-au/whois-status-codes#serverRenewProhibited|clientUpdateProhibited https://identitydigital.au/get-au/whois-status-codes#clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc. incorporated in the State of Delaware",
                        "registrantName": "MarkMonitor Corporate Services Inc",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Corporate Services Inc",
                        "registrantCountry": "ITALY",
                        "expirationDate": null,
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.services",
                        "createdDate": "2016-02-17T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-17T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "nemeannetworks.net",
                        "createdDate": "2005-07-15T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-07-15T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "transformsecurity.com",
                        "createdDate": "2016-04-25T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-04-25T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualysguard.asia",
                        "createdDate": "2008-03-22T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-03-22T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.co.uk",
                        "createdDate": "2004-06-09T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "Registered until expiry date.",
                        "registrantOrganization": null,
                        "registrantName": "Markmonitor Inc. [Tag = MARKMONITOR]",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "Markmonitor Inc. [Tag = MARKMONITOR]",
                        "registrantCountry": null,
                        "expirationDate": "2026-06-09T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.com",
                        "createdDate": "1999-02-09T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientUpdateProhibited clientTransferProhibited clientDeleteProhibited serverUpdateProhibited serverTransferProhibited serverDeleteProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor, Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor, Inc.",
                        "registrantCountry": null,
                        "expirationDate": "2026-02-09T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.fr",
                        "createdDate": "2004-11-26T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "ACTIVE",
                        "registrantOrganization": "Qualys Technologies, SA",
                        "registrantName": "MARKMONITOR Inc.",
                        "registrantEmail": "domain-admin@qualys.com",
                        "registrantContact": "16508016100",
                        "registrar": "MARKMONITOR Inc.",
                        "registrantCountry": "FRANCE",
                        "expirationDate": "2026-11-26T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "layeredinsight.com",
                        "createdDate": "2016-01-22T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-01-22T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualysguard.tw",
                        "createdDate": "2009-02-25T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientUpdateProhibited,clientTransferProhibited,clientDeleteProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "Markmonitor, Inc.|Registration Service URL: http://www.markmonitor.com/|Provided by Registry Services, LLC. Registry Gateway Services",
                        "registrantEmail": "domain-admin@qualys.com",
                        "registrantContact": null,
                        "registrar": "Markmonitor, Inc.|Registration Service URL: http://www.markmonitor.com/|Provided by Registry Services, LLC. Registry Gateway Services",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-25T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.us",
                        "createdDate": "2009-02-23T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientUpdateProhibited clientTransferProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor, Inc.",
                        "registrantEmail": "domain-admin@qualys.com",
                        "registrantContact": "16508016169",
                        "registrar": "MarkMonitor, Inc.",
                        "registrantCountry": "FRANCE",
                        "expirationDate": "2026-02-22T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.biz",
                        "createdDate": "2013-04-27T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientUpdateProhibited clientTransferProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor, Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor, Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-04-26T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.mx",
                        "createdDate": "2009-09-16T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": null,
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "Markmonitor",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "Markmonitor",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-09-15T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.it",
                        "createdDate": "2014-11-27T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "ok",
                        "registrantOrganization": "Qualys Technologies, SA",
                        "registrantName": "MarkMonitor International Limited",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor International Limited",
                        "registrantCountry": "FRANCE",
                        "expirationDate": "2025-09-21T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.ae",
                        "createdDate": null,
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited|clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor",
                        "registrantCountry": null,
                        "expirationDate": null,
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.report",
                        "createdDate": "2016-02-17T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-17T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.in",
                        "createdDate": "2009-02-23T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientUpdateProhibited clientTransferProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-23T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.cloud",
                        "createdDate": "2018-09-12T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-09-12T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.hosting",
                        "createdDate": "2016-02-17T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientTransferProhibited clientUpdateProhibited clientDeleteProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor, Inc (TLDs)",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor, Inc (TLDs)",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-17T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.io",
                        "createdDate": "2016-02-17T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-02-17T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.eu",
                        "createdDate": null,
                        "dnssec": null,
                        "domainStatus": null,
                        "registrantOrganization": "NOT DISCLOSED!",
                        "registrantName": "MarkMonitor International Limited",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor International Limited",
                        "registrantCountry": null,
                        "expirationDate": null,
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.at",
                        "createdDate": null,
                        "dnssec": null,
                        "domainStatus": null,
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc. ( https://nic.at/registrar/434 )",
                        "registrantEmail": "domain-admin@qualys.com",
                        "registrantContact": "16508016100",
                        "registrar": "MarkMonitor Inc. ( https://nic.at/registrar/434 )",
                        "registrantCountry": "United States of America (the)",
                        "expirationDate": null,
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "csoblog.net",
                        "createdDate": "2003-06-14T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-06-14T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "nemeannetworks.com",
                        "createdDate": "2005-07-15T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-07-15T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualys.asia",
                        "createdDate": "2008-03-22T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-03-22T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                    {
                        "domain": "qualysguard.com",
                        "createdDate": "2000-04-21T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-04-21T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    }
                ],
                "organizationName": [
                    "Layered Insight, Inc.",
                    "Qualys, Inc"
                ],
                "isp": "QUALYS, Inc.",
                "asn": "AS27385",
                "easmTags": [],
                "hostingCategory1": "ThirdParty",
                "customAttributes": null,
                "lparId": null,
                "processor": {
                    "description": null,
                    "speed": null,
                    "numCPUs": 0,
                    "noOfSocket": null,
                    "threadsPerCore": null,
                    "coresPerSocket": null,
                    "multithreadingStatus": null
                }
            }
        ]
    }
}

Updated API: Get Host Details of All Assets

New or Updated API Updated
API Endpoint /rest/2.0/search/am/asset
Method POST
DTD or XSD changes Not Applicable

Use this API to fetch the domain details associated with the asset based on the whoIs.registrantCountry and whoIs.expirationDate filters.

Sample: Fetch the domains within the provided filtersSample: Fetch the domains within the provided filters

API Request with Filter in XML

curl -X POST
'<qualys_base_url>/rest/2.0/search/am/asset'
-H 'Accept: application/xml'
-H 'Authorization: Bearer <JWTToken>'
-data-raw
<FilterRequest>
    <filters>
        <Criteria field="whoIs.registrantCountry" operator="EQUALS">
            <value>UNITED STATES</value>
        </Criteria>
        <Criteria field="whoIs.expirationDate" operator="EQUALS">
            <value>2026-09-12</value>
        </Criteria>
    </filters>
    <operation>AND</operation>
</FilterRequest>

API Request with Filter in JSON

curl -X POST
'<qualys_base_url>/rest/2.0/search/am/asset'
-H 'Accept: application/json'
-H 'Authorization: Bearer <JWTToken>'
-data-raw
{
  "filters": [
    {
      "value": "FRANCE",
      "field": "whoIs.registrantCountry",
      "operator": "EQUALS"
    },
    {
      "value": "2026-02-22",
      "field": "whoIs.expirationDate",
      "operator": "EQUALS"
    }
  ],
  "operation": "AND"
}

API Response

{
    "responseMessage": "Valid API Access",
    "count": 1,
    "responseCode": "SUCCESS",
    "lastSeenAssetId": null,
    "hasMore": 0,
    "assetListData": {
        "asset": [
            {
                "assetId": 50899050,
                "assetUUID": "9b62500d-2f1d-41e0-9bd5-2b90bb840d66",
                "hostId": 1118597111841,
                "lastModifiedDate": "2025-04-12T13:51:37.000Z",
                "agentId": null,
                "createdDate": "2024-11-18T06:52:22.000Z",
                "sensorLastUpdatedDate": "2025-04-12T13:51:37.000Z",
                "assetType": "HOST",
                "address": "169.62.90.147",
                "dnsName": null,
                "assetName": "169.62.90.147",
                "netbiosName": null,
                "timeZone": null,
                "biosDescription": null,
                "lastBoot": null,
                "totalMemory": 0,
                "cpuCount": 0,
                "lastLoggedOnUser": null,
                "domainRole": null,
                "hwUUID": "7e43a4b0-75d6-40dd-80fe-6bbd26176c4e",
                "biosSerialNumber": "2197A8W",
                "biosAssetTag": "",
                "isContainerHost": false,
                "operatingSystem": {
                    "osName": "AIX 7.1",
                    "fullName": "IBM AIX 7.1",
                    "category": "Unix / Server",
                    "category1": "Unix",
                    "category2": "Server",
                    "productName": "AIX",
                    "publisher": "IBM",
                    "edition": null,
                    "marketVersion": "7",
                    "version": "7.1",
                    "update": "7.1",
                    "architecture": null,
                    "lifecycle": {
                        "gaDate": "2010-09-10T00:00:00.000Z",
                        "eolDate": "2022-04-30T00:00:00.000Z",
                        "eosDate": "2022-04-30T00:00:00.000Z",
                        "stage": "EOL/EOS",
                        "lifeCycleConfidence": "Exact",
                        "eolSupportStage": "Service Pack Support",
                        "eosSupportStage": "Service Pack Support",
                        "detectionScore": 40
                    },
                    "taxonomy": {
                        "id": null,
                        "name": "Unix / Server",
                        "category1": "Unix",
                        "category2": "Server"
                    },
                    "productUrl": "https://www.ibm.com/in-en/it-infrastructure/power/os/aix,https://en.wikipedia.org/wiki/IBM_AIX,https://www-01.ibm.com/support/docview.wss?uid=isg1SSRVPOAIX72TIPS171103-0829",
                    "productFamily": null,
                    "installDate": null,
                    "release": "7.1",
                    "cpeId": null,
                    "cpe": null,
                    "cpeType": null
                },
                "hardware": {
                    "fullName": "IBM Power System S824 8286-42A",
                    "category": "Computers / Server",
                    "category1": "Computers",
                    "category2": "Server",
                    "manufacturer": "IBM",
                    "productName": "Power System S824",
                    "model": "8286-42A",
                    "lifecycle": {
                        "introDate": null,
                        "gaDate": "2014-06-10T00:00:00.000Z",
                        "eosDate": "2019-02-28T00:00:00.000Z",
                        "obsoleteDate": "2024-03-31T00:00:00.000Z",
                        "stage": "OBS",
                        "lifeCycleConfidence": "Exact"
                    },
                    "taxonomy": {
                        "id": null,
                        "name": "Computers / Server",
                        "category1": "Computers",
                        "category2": "Server"
                    },
                    "productUrl": "http://www-01.ibm.com/common/ssi/ShowDoc.wss?docURL=/common/ssi/rep_sm/2/760/ENUS8286-_h02/index.html&lang=en&request_locale=en,,",
                    "productFamily": null
                },
                "userAccountListData": {
                    "userAccount": [
                        {
                            "name": "utbdna"
                        },
                        {
                            "name": "oraoam"
                        },
                        {
                            "name": "giani"
                        },
                        {
                            "name": "sshd"
                        },
                    ]
                },
                "openPortListData": {
                    "openPort": [
                        {
                            "port": 443,
                            "description": "http protocol over TLS/SSL",
                            "protocol": "TCP",
                            "detectedService": "HTTPs",
                            "firstFound": "2025-04-09T12:38:00.000Z",
                            "lastUpdated": "2025-04-09T12:38:00.000Z",
                            "authorization": null,
                            "detectionScore": null,
                            "discoverySources": "EASM"
                        }
                    ]
                },
                "volumeListData": {
                    "volume": [
                        {
                            "name": "/dev/hd2",
                            "free": 16777216,
                            "size": 13474024
                        },
                    ]
                },
                "networkInterfaceListData": {
                    "networkInterface": [
                        {
                            "hostname": null,
                            "addressIpV4": "169.62.90.147",
                            "addressIpV6": null,
                            "macAddress": "01:00:5e:00:00:01",
                            "interfaceName": "en0",
                            "dnsAddress": null,
                            "gatewayAddress": "",
                            "manufacturer": null,
                            "macVendorIntroDate": null,
                            "netmask": "255.255.255.0",
                            "addresses": null
                        },
                    ]
                },
                "softwareListData": {
                    "software": [
                        {
                            "id": -4289165170931091461,
                            "discoverySources": "EASM",
                            "fullName": "F5 Nginx Server",
                            "softwareType": "Application",
                            "isIgnored": false,
                            "ignoredReason": null,
                            "category": "Network Application / Web Servers",
                            "category1": "Network Application",
                            "category2": "Web Servers",
                            "productName": "Nginx",
                            "component": "Server",
                            "publisher": "F5",
                            "edition": "Unknown",
                            "marketVersion": "Unknown",
                            "version": null,
                            "update": null,
                            "architecture": null,
                            "installDate": null,
                            "installPath": null,
                            "lastUpdated": null,
                            "lastUseDate": null,
                            "language": null,
                            "formerlyKnownAs": null,
                            "isPackage": false,
                            "isPackageComponent": false,
                            "packageName": null,
                            "productUrl": "http://nginx.org/en/download.html,,",
                            "lifecycle": {
                                "gaDate": null,
                                "eolDate": null,
                                "eosDate": null,
                                "stage": "Not Applicable",
                                "lifeCycleConfidence": "Exact",
                                "eolSupportStage": " ",
                                "eosSupportStage": " ",
                                "detectionScore": 6
                            },
                            "supportStageDesc": null,
                            "license": {
                                "category": "Open Source",
                                "subcategory": "BSD 2-Clause License (FreeBSD/Simplified)"
                            },
                            "authorization": null,
                            "discoveredPublisher": null,
                            "discoveredName": "nginx",
                            "discoveredVersion": null,
                            "authorizationDetectionScore": null,
                            "cpeId": null,
                            "cpe": null,
                            "cpeType": null,
                            "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": 1744465884000,
                    "lastEasmScanDate": 1744465884000
                },
                "container": {
                    "product": null,
                    "version": null,
                    "noOfContainers": 0,
                    "noOfImages": 0,
                    "hasSensor": null
                },
                "inventory": {
                    "source": "IP",
                    "created": 1731912742000,
                    "lastUpdated": 1744465897000
                },
                "activity": {
                    "source": "IP",
                    "lastScannedDate": 1744465897000
                },
                "tagList": {
                    "tag": [
                        {
                            "tagId": 39233480,
                            "tagName": "qq",
                            "foregroundColor": 0,
                            "backgroundColor": 0,
                            "businessImpact": null,
                            "criticalityScore": null
                        },
                    ]
                },
                "serviceList": {
                    "service": []
                },
                "lastLocation": {
                    "city": null,
                    "state": null,
                    "country": "United States",
                    "name": "United States",
                    "continent": "North America",
                    "postal": null
                },
                "criticality": {
                    "score": 3,
                    "isDefault": false,
                    "lastUpdated": "2025-03-31T01:05:20.000Z"
                },
                "businessInformation": null,
                "assignedLocation": null,
                "businessAppListData": null,
                "riskScore": 606,
                "passiveSensor": null,
                "domain": [
                    "qualys.tv",
                ],
                "subdomain": [
                    "www.qualys.com",
                ],
                "missingSoftware": [],
                "whois": [
                    {
                        "domain": "qualys.tv",
                        "createdDate": "2018-09-12T00:00:00.000Z",
                        "dnssec": null,
                        "domainStatus": "clientDeleteProhibited clientTransferProhibited clientUpdateProhibited",
                        "registrantOrganization": "Qualys, Inc.",
                        "registrantName": "MarkMonitor, Inc.",
                        "registrantEmail": null,
                        "registrantContact": null,
                        "registrar": "MarkMonitor, Inc.",
                        "registrantCountry": "UNITED STATES",
                        "expirationDate": "2026-09-12T00:00:00.000Z",
                        "updatedDate": "2025-04-12T00:00:00.000Z"
                    },
                ],
                "organizationName": [
                    "Layered Insight, Inc.",
                    "Qualys, Inc"
                ],
                "isp": "QUALYS, Inc.",
                "asn": "AS27385",
                "easmTags": [],
                "hostingCategory1": "ThirdParty",
                "customAttributes": null,
                "lparId": null,
                "processor": {
                    "description": null,
                    "speed": null,
                    "numCPUs": 0,
                    "noOfSocket": null,
                    "threadsPerCore": null,
                    "coresPerSocket": null,
                    "multithreadingStatus": null
                }
            }
        ]
    }
}

EASM Scan Access Control through EASM APIs

Only managers can enable or disable the EASM Scan option. If a non-manager user tries to create or update the EASM profile with the enableEASMScan parameter set to true, the following error message is displayed:

Only a Manager in your subscription can enable/disable the EASM Scan.

For more details, refer to the EASM Scan Access Control Enhancement.

The following EASM APIs are impacted due to the above change:

JWT Token Generation using Client ID and Secret Key

You can generate the JWT access token by providing the client ID and client secret key in the following API request headers.

For more information on client ID and client secret key, refer to Support for Auth ID Client Management from UI.

JWT Access Token RequestJWT Access Token Request

API Request

curl -X POST
'<qualys_base_url>/auth/oidc'
--header 'clientSecret: wJalrXUtnFEMI/K7MDENG+bPxRfiCYEXAMPLEKEY'
--header 'clientId: 123e4567-e89b-12d3-a456-426614174000'
--data-raw ''

API Response (contains JWT access token)

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.
eyJzdWIiOiJjbGllbnQxMjM0NTYiLCJzYwZXM
iOlsiYXBpLnJlYWQiLCJhcGkud3JpdGUiXSwia
XNzIjoiaHR0cHM6Ly9kdW1teS1hdXRoLmNvbSI
sImV4cCI6MTcwMDAwMDAwMH0.SdXn3I6yTb-
JNk9LPjR8W9xAtH7dN3Mqf3HdJ5WnRfE

Once the JWT access token is successfully generated, you can use it to authenticate your API requests. Include the token in the Authorization header of API requests. 

The system validates the JWT token and authorizes the request based on the user's permissions. See the below example, where a user with API access calls an API to update the EASM profile data.

Example API: Update the EASM Profile DataExample API: Update the EASM Profile Data

API Request

curl -X PUT
'<qualys_base_url>/easm/v2/profile/newProfile'
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6Ik....... '
--header 'Content-Type: application/json'
--data ' {
          "name": "newProfile",
          "includeSeeds": [
            {
              "seedType": "DOMAIN",
              "seedValue": "qualysss.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": true
        }'

API Response 

{
 "code": "200",
 "status": "UPDATED",
 "date": "2024-01-15 10:59:08",
 "message": "Profile Updated Successfully"
}
Impacted APIs

The generated JWT access token can be used to authenticate the following APIs.

API Endpoint
Import Asset Business Metadata /rest/2.0/update/am/asset/business/metadata
Import Business App Metadata /rest/2.0/update/am/businessapp/metadata
Get an EASM Profile Discovery Status /easm/v2/profile/status
Get an EASM Profile Data /easm/v2/profile
Delete an EASM Profile /easm/v2/profile
Create an EASM Profile /easm/v2/profile
Update the EASM Profile Data /easm/v2/profile/{profileName}
Patch an EASM Profile Data /easm/v2/profile/{profileName}
Activate and Deactivate an EASM Profile /easm/v2/profile/activate/{profileName}