Certificate View Release 4.4 API
June 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.
Updated CertView V2 API: Enhanced the API to Include Key Algorithm Information
|
New or Updated API |
Updated |
|
API Endpoint (deprecation Timeline: December 2025 |
/certview/v2/certificates |
|
API Endpoint |
/certview/v2.1/certificates |
|
Method |
GET |
|
DTD or XSD changes |
Not Applicable |
The updated API response of this new version of API features an important new field that specifies the key algorithm in use, such as RSA or ECC, as well as the key size, including options like 256, 384, 512, and 768.
This enhancement allows users to easily assess the security posture of their assets by identifying whether they are using RSA or ECC keys. As a result, it minimizes the manual effort needed for security evaluations and enables users to mitigate potential security risks more effectively.
Now you can use certificate.publicKeyAlgorithm as a filter value to get the response based on the key algorithm used.
For more information on input parameters, refer to the Certificate View API User guide.
Input Parameter
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
|
filter:
|
Optional |
String |
Filter the events list by For example,
|
Sample shows request and response using certificate.publicKeyAlgorithma filter valueSample shows request and response using certificate.publicKeyAlgorithma filter value
API Request
curl -X 'POST'
'<qualys_base_url>/certview/v2.1/certificates'
-H 'accept: application/json'
-H 'Authorization: Bearer <JWT Token>
-H 'Content-Type: application/json'
-d' {
"filter": {
"filters": [
{
"field": "certificate.publicKeyAlgorithm",
"value": "RSA",
"operator": "EQUALS"
}
],
"operation": "AND"
},
"pageNumber": 0,
"pageSize": 10,
"includes": [
"ASSET_INTERFACES"
],
"assetType": "MANAGED"
}'
Response
[
{
"id": 2163312,
"certhash": "6dca79243d2c31796050ebcfa6bc251f28f1805dd6528149d55e6ced047a6c47",
"keySize": 2048,
"serialNumber": "01434c80ea24163a54663a1a7c729492",
"validToDate": "2025-09-03T23:59:59.000+00:00",
"validTo": 1756943999000,
"validFromDate": "2024-09-04T00:00:00.000+00:00",
"validFrom": 1725408000000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2024-09-17T05:18:00.000+00:00",
"dn": "CN=example.qualys.com, O=\"Qualys, Inc.\", L=Foster City, ST=California, C=US",
"subject": {
"organization": "Qualys, Inc.",
"locality": "Foster City",
"name": "example.qualys.com",
"state": "California",
"country": "US",
"organizationUnit": []
},
"updateDate": "2025-05-05T07:22:56.000+00:00",
"lastFound": 1746429776000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "DigiCert Inc",
"organizationUnit": [],
"name": "DigiCert Global G2 TLS RSA SHA256 2020 CA1",
"country": "US",
"state": "",
"certhash": "c8025f9fc65fdfc95b3ca8cc7867b9a587b5277973957917463fc813d0b625a9",
"locality": ""
},
"rootissuer": {
"organization": "DigiCert Inc",
"organizationUnit": [
"www.digicert.com"
],
"name": "DigiCert Global Root G2",
"country": "US",
"state": "",
"certhash": "cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1cb5f",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"assets": [
{
"id": 45197700,
"uuid": "8ae40c50-40d7-446d-a815-1dad55e496c2",
"netbiosName": "",
"name": "example.qualys.com",
"operatingSystem": "Tandberg Device / CentOS",
"hostInstances": [
{
"id": 27823184,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "A+"
}
],
"assetInterfaces": [
{
"hostname": "example.qualys.com",
"address": "10.xx.xxx.xx"
}
],
"primaryIp": "10.xx.xxx.xx"
}
],
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 2446837,
"certhash": "a7183d7adc8cff9eb492232dc42c134c5c2cf55ab3c907ec6697b05ca2199686",
"keySize": 2048,
"serialNumber": "0aecf066456ea2411cbdf932d5aeced0",
"validToDate": "2025-09-03T23:59:59.000+00:00",
"validTo": 1756943999000,
"validFromDate": "2024-09-04T00:00:00.000+00:00",
"validFrom": 1725408000000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2024-10-04T11:34:18.000+00:00",
"dn": "CN=example.intranet.qualys.com, O=\"Qualys, Inc.\", L=Foster City, ST=California, C=US",
"subject": {
"organization": "Qualys, Inc.",
"locality": "Foster City",
"name": "example.intranet.qualys.com",
"state": "California",
"country": "US",
"organizationUnit": []
},
"updateDate": "2025-05-13T11:00:43.000+00:00",
"lastFound": 1747134043000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "DigiCert Inc",
"organizationUnit": [],
"name": "DigiCert Global G2 TLS RSA SHA256 2020 CA1",
"country": "US",
"state": "",
"certhash": "c8025f9fc65fdfc95b3ca8cc7867b9a587b5277973957917463fc813d0b625a9",
"locality": ""
},
"rootissuer": {
"organization": "DigiCert Inc",
"organizationUnit": [
"www.digicert.com"
],
"name": "DigiCert Global Root G2",
"country": "US",
"state": "",
"certhash": "cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1cb5f",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"assets": [
{
"id": 44276804,
"uuid": "6ef04d50-2930-47be-a4b1-9b4d3c4a3ac7",
"netbiosName": "",
"name": "example.intranet.qualys.com",
"operatingSystem": "Tandberg Device / CentOS",
"hostInstances": [
{
"id": 21361190,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "A-"
}
],
"assetInterfaces": [
{
"hostname": "example.intranet.qualys.com",
"address": "10.xx.xxx.xx"
}
],
"primaryIp": "10.xx.xxx.xx"
}
],
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 2548277,
"certhash": "4da40702a78418deaa09697a4c80e650a5fe088000644f0439289920a7cb72d2",
"keySize": 2048,
"serialNumber": "0deaf9b469fdce8198cd6c9e1bb87d10",
"validToDate": "2025-12-17T23:59:59.000+00:00",
"validTo": 1766015999000,
"validFromDate": "2024-12-18T00:00:00.000+00:00",
"validFrom": 1734480000000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-01-02T14:24:43.000+00:00",
"dn": "CN=www.qualys.com, O=\"Qualys, Inc.\", L=Foster City, ST=California, C=US, serialNumber=3152140, businessCategory=Private Organization, StateOrProvince=Delaware, CountryName=US",
"subject": {
"organization": "Qualys, Inc.",
"locality": "Foster City",
"name": "www.qualys.com",
"state": "California",
"country": "US",
"organizationUnit": []
},
"updateDate": "2025-05-13T11:18:01.000+00:00",
"lastFound": 1747135081000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "DigiCert Inc",
"organizationUnit": [
"www.digicert.com"
],
"name": "DigiCert SHA2 Extended Validation Server CA",
"country": "US",
"state": "",
"certhash": "403e062a2653059113285baf80a0d4ae422c848c9f78fad01fc94bc5b87fef1a",
"locality": ""
},
"rootissuer": {
"organization": "DigiCert Inc",
"organizationUnit": [
"www.digicert.com"
],
"name": "DigiCert High Assurance EV Root CA",
"country": "US",
"state": "",
"certhash": "7431e5f4c3c1ce4690774f0b61e05440883ba9a01ed00ba6abd7806ed3b118cf",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"EASM",
"VM"
],
"assets": [
{
"id": 47092745,
"uuid": "ef0d52e5-7fd6-455f-8ebe-2243311d50b6",
"netbiosName": "",
"name": "www.qualys.com",
"hostInstances": [
{
"id": 21937410,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "A-"
}
],
"assetInterfaces": [
{
"hostname": "www.qualys.com",
"address": "64.xx.xxx.xx"
}
],
"primaryIp": "64.xx.xxx.xx"
}
],
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 3462197,
"certhash": "85304f89bc84c259fb079092e5d687fe65ac97172a67d7bcdea87c576ef9da27",
"keySize": 2048,
"serialNumber": "60c452c8620beea4477368e64308e2a1",
"validToDate": "2026-12-08T19:06:48.000+00:00",
"validTo": 1796756808000,
"validFromDate": "2024-09-09T19:06:49.000+00:00",
"validFrom": 1725908809000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-03-11T06:40:49.000+00:00",
"dn": "CN=examplecom, OU=Operations and Infrastructure, O=Visa Inc., C=US, ST=Virginia, L=Ashburn",
"subject": {
"organization": "Visa Inc.",
"locality": "Ashburn",
"name": "example.visa.com",
"state": "Virginia",
"country": "US",
"organizationUnit": [
"Operations and Infrastructure"
]
},
"updateDate": "2025-03-11T06:40:49.000+00:00",
"lastFound": 1741675249000,
"imported": true,
"selfSigned": false,
"issuer": {
"organization": "Visa Inc.",
"organizationUnit": [
"Cybersecurity - Applied Crypto"
],
"name": "Visa Sandbox Issuing CA",
"country": "US",
"state": "",
"certhash": "",
"locality": ""
},
"instanceCount": 0,
"assetCount": 0,
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 3465430,
"certhash": "6ff8ae4234c67b8c04488951c72ee455e7962bb4932f47f1d1b1880efdeffcfc",
"keySize": 4096,
"serialNumber": "56e4ac98392c6221d73b84be8483387bd49d9595",
"validToDate": "2026-02-21T04:33:38.000+00:00",
"validTo": 1771648418000,
"validFromDate": "2025-02-21T04:33:39.000+00:00",
"validFrom": 1740112419000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-03-18T04:56:16.000+00:00",
"dn": "CN=ejbca.example.qualys.com, OU=Operations, O=\"Qualys, Inc,\b.\", L=Foster City, ST=California, C=US",
"subject": {
"organization": "Qualys, Inc,\b.",
"locality": "Foster City",
"name": "ejbca.example.qualys.com",
"state": "California",
"country": "US",
"organizationUnit": [
"Operations"
]
},
"updateDate": "2025-03-18T04:56:16.000+00:00",
"lastFound": 1742273776000,
"imported": true,
"selfSigned": false,
"issuer": {
"organization": "Qualys, Inc.",
"organizationUnit": [
"Operations"
],
"name": "Qualys Issuing CA - G1",
"country": "US",
"state": "",
"certhash": "7e6f835a32c25732283fdf1cb9bccc200d27e9f35bb754f7e402581bd8366f8b",
"locality": ""
},
"rootissuer": {
"organization": "Qualys, Inc.",
"organizationUnit": [
"Operations"
],
"name": "Qualys Root CA - G1",
"country": "US",
"state": "",
"certhash": "2a1d95f5530c489c25bb90013939d1bfde7eeb3a5067c2ef281f21ea927873db",
"locality": ""
},
"instanceCount": 0,
"assetCount": 0,
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 3493465,
"certhash": "a9ab5376dab60367a977618421574cecc4092d4ff9bf4e609670afec15bac774",
"keySize": 2048,
"serialNumber": "1614efc551fa14a04a9840c6dc1338fa",
"validToDate": "2025-07-09T18:30:00.000+00:00",
"validTo": 1752085800000,
"validFromDate": "2025-01-07T18:30:00.000+00:00",
"validFrom": 1736274600000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-03-28T03:35:05.000+00:00",
"dn": "CN=WIN-P8S24QHD09L",
"subject": {
"organization": "",
"locality": "",
"name": "WIN-P8S24QHD09L",
"state": "",
"country": "",
"organizationUnit": []
},
"updateDate": "2025-04-03T03:33:27.000+00:00",
"lastFound": 1743651207000,
"imported": false,
"selfSigned": true,
"issuer": {
"organization": "",
"organizationUnit": [],
"name": "WIN-P8S24QHD09L",
"country": "",
"state": "",
"certhash": "",
"locality": ""
},
"issuerCategory": "Self-Signed",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"assets": [
{
"id": 50293148,
"uuid": "1dc38361-34df-4646-ad59-1375da766fd8",
"netbiosName": "",
"name": "10.xx.xx.xx",
"operatingSystem": "Microsoft Windows",
"hostInstances": [
{
"id": 27843720,
"port": 3389,
"fqdn": "",
"protocol": "tcp",
"service": "ms-wbt-server",
"grade": "T"
}
],
"assetInterfaces": [
{
"hostname": null,
"address": "10.xx.xxx.xx"
}
],
"primaryIp": "10.xx.xxx.xx"
}
],
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 3538844,
"certhash": "8f9db83d6e55237b861631ef9659f29c9194b0276543581452e4d3de5d80e417",
"keySize": 4096,
"serialNumber": "0b3b6bef878d9541f0416ebef82d4791",
"validToDate": "2026-03-25T23:59:59.000+00:00",
"validTo": 1774483199000,
"validFromDate": "2025-03-27T00:00:00.000+00:00",
"validFrom": 1743033600000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-04-16T09:43:34.000+00:00",
"dn": "CN=abc.qualys.com, O=\"Qualys, Inc\", L=Foster City, ST=California, C=US",
"subject": {
"organization": "Qualys, Inc",
"locality": "Foster City",
"name": "abc.qualys.com",
"state": "California",
"country": "US",
"organizationUnit": []
},
"updateDate": "2025-04-16T09:43:34.000+00:00",
"lastFound": 1744796614000,
"imported": true,
"selfSigned": false,
"issuer": {
"organization": "DigiCert Inc",
"organizationUnit": [],
"name": "DigiCert Test SHA2 Intermediate CA-1",
"country": "US",
"state": "",
"certhash": "a52d05988b61a33d6ac3edb449eb47150fa5b7a26c7dfc4e61f905ca36e165ee",
"locality": ""
},
"rootissuer": {
"organization": "DigiCert Inc",
"organizationUnit": [
"www.digicert.com"
],
"name": "DigiCert Test Root CA",
"country": "US",
"state": "",
"certhash": "a3ac53581e043271878a12124c36660a443321e5a68418c3bc56dab9b1a4d674",
"locality": ""
},
"instanceCount": 0,
"assetCount": 0,
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 3538845,
"certhash": "6f333b53885a1a0720733a0304f53e1ea31e5ad90be0f71bf6c7127e01b0d72a",
"keySize": 3072,
"serialNumber": "6233fb68f1cc4df01447ef492fb07a0d4db2c21b",
"validToDate": "2026-03-27T12:01:56.000+00:00",
"validTo": 1774612916000,
"validFromDate": "2025-03-27T12:01:57.000+00:00",
"validFrom": 1743076917000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-04-16T09:43:34.000+00:00",
"dn": "CN=abc.com, OU=Operations, O=\"Qualys, Inc.\", L=Foster City, ST=California, C=US",
"subject": {
"organization": "Qualys, Inc.",
"locality": "Foster City",
"name": "abc.com",
"state": "California",
"country": "US",
"organizationUnit": [
"Operations"
]
},
"updateDate": "2025-04-16T09:43:34.000+00:00",
"lastFound": 1744796614000,
"imported": true,
"selfSigned": false,
"issuer": {
"organization": "Qualys, Inc.",
"organizationUnit": [
"Operations"
],
"name": "Qualys Test CA - G1",
"country": "US",
"state": "",
"certhash": "",
"locality": ""
},
"instanceCount": 0,
"assetCount": 0,
"type": "Leaf",
"publicKeyAlgorithm": "RSA"
},
{
"id": 3542049,
"certhash": "29f59ba543747af6aa8e918d9b857c95854d7c6e5d18995d0db0559cc3471278",
"keySize": 2048,
"serialNumber": "37799f32b02555874b72ff9ed8bcfcc5",
"validToDate": "2025-07-03T08:22:48.000+00:00",
"validTo": 1751530968000,
"validFromDate": "2025-01-01T08:22:48.000+00:00",
"validFrom": 1735719768000,
"signatureAlgorithm": "SHA1withRSA",
"extendedValidation": false,
"createdDate": "2025-04-24T09:29:32.000+00:00",
"dn": "CN=qw28uv4-65-163",
"subject": {
"organization": "",
"locality": "",
"name": "qw28uv4-65-163",
"state": "",
"country": "",
"organizationUnit": []
},
"updateDate": "2025-05-13T11:34:00.000+00:00",
"lastFound": 1747136040000,
"imported": false,
"selfSigned": true,
"issuer": {
"organization": "",
"organizationUnit": [],
"name": "qw28uv4-65-163",
"country": "",
"state": "",
"certhash": "",
"locality": ""
},
"issuerCategory": "Self-Signed",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"assets": [
{
"id": 33237439,
"uuid": "f67edd6d-f31c-43a3-96b2-e890dcb879c4",
"netbiosName": "QW28UV4-65-163",
"name": "10.xx.xx.xx",
"operatingSystem": "Microsoft Windows Server 2008 Enterprise (6.0 SP2)",
"hostInstances": [
{
"id": 28356154,
"port": 3389,
"fqdn": "",
"protocol": "tcp",
"service": "ms-wbt-server",
"grade": "T"
}
],
"assetInterfaces": [
{
"hostname": "qw28uv4-65-163",
"address": "10.xx.xxx.xx"
}
],
"primaryIp": "10.xx.xxx.xx"
}
],
"type": "Leaf",
" >publicKeyAlgorithm": "RSA "
}
]