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.
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.
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.
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.
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 - LESS_THAN |
Fetch domains based on the expiration date. |
The following APIs are impacted due to the enhancement:
- Get the Count of Unresolved Domains
- Get the List of Unresolved Domains
- Get Count of Assets
- Get Host Details of Specific Asset
- Get Host Details of All Assets
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.
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.
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.
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.
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:
- Create an EASM Profile (/easm/v2/profile)
- Update the EASM Profile Data (/easm/v2/profile/{profileName})
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} |