Certificate View Release 4.7 API
November 12, 2025
Before understanding the API release highlights, learn more about the API server URL for 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.
List CertView Certificates (v2) API: PQC Support
With this release, the List CertView Certificates (v2) API now supports filtering and retrieving certificates through Post-Quantum Cryptography (PQC).
|
New or Updated API |
New |
|
API Endpoints |
/certview/v2.3/certificates |
|
Method |
POST |
|
DTD or XSD changes |
Not Applicable |
With this enhancement, we have introduced the instance.pqcSupport filter along with the field PQC-supported algorithms that allows filtering certificates based on PQC support status (true or false). The field PQC_SUPPORTED_ALGORITHMS
Input Parameter
|
Parameter |
Mandatory/ |
Data Type |
Description |
|---|---|---|---|
|
filter:
|
Optional |
Boolean |
Filter the certificates list by using the values true or false for displaying PQC-supported certificates Example:
|
Sample 1: Response to get details of certificates based on PQC support Sample 1: Response to get details of certificates based on PQC support
API Request
curl -X 'POST'
'<qualys_base_url>/certview/v2.3/certificates'
-H 'accept: application/json'
-H 'Authorization: Bearer <JWT Token>
-H 'Content-Type: application/json'
-d '{
"filter": {
"filters": [
{
"field": "instance.pqcSupport",
"value": "true",
"operator": "EQUALS"
}
],
"operation": "AND"
},
"pageNumber": 0,
"pageSize": 10,
"includes": [
"ASSET_INTERFACES",
"PQC_SUPPORTED_ALGORITHMS"
],
"excludeFields": "",
"assetType": "MANAGED"
}'
Response
[
{
"id": 1168737,
"certhash": "5f9aeccxxxxxxxxxxxxxxxxxxxxf6dd320c8ca5a0ceb7f09c985ebf0696934fc",
"keySize": 4096,
"serialNumber": "21e5b9a0cc956de278ca012ba8fdc58a98b3fbea",
"validToDate": "2040-10-14T13:35:12.000+00:00",
"validTo": 2233834512000,
"validFromDate": "2020-10-14T13:35:12.000+00:00",
"validFrom": 1602682512000,
"signatureAlgorithm": "SHA384withRSA",
"extendedValidation": false,
"createdDate": "2024-06-25T08:35:37.000+00:00",
"dn": "CN=certificate-view.qualys-test, OU=FPKI, O=U.S. Government, C=US",
"subject": {
"organization": "certificate-view.qualys-test",
"locality": "",
"name": "certificate-view.qualys-test.com",
"state": "",
"country": "US",
"organizationUnit": []
},
"updateDate": "2024-11-19T04:01:14.000+00:00",
"lastFound": 1731988874000,
"imported": true,
"selfSigned": true,
"issuer": {
"organization": "certificate-view.qualys-test",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "",
"locality": ""
},
"issuerCategory": "Self-Signed",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"type": "Root",
"publicKeyAlgorithm": "",
"revocationStatus": "Not Available",
"assets": [
{
"id": 70412578,
"uuid": "abc6d649-ac28-4243-ab8b-131a5955024e",
"netbiosName": "VP0PMEMCASPTRS8",
"name": "certificate-view.qualys-test.com",
"operatingSystem": "Microsoft Windows",
"assetInterfaces": [
{
"hostname": "xxxxxxxx_xxxx_xxxxxxxx",
"address": "xx.xx.xx.xx"
}
],
"primaryIp": "xx.xx.xx.xx",
"created": "2025-07-31T09:55:24.000+00:00",
"updated": "2025-08-05T17:43:33.000+00:00",
"hostInstances": [
{
"id": 33248228,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "F",
"pqcSupportedAlgorithms": [
"X25519MLKEM768"
]
}
]
}
]
},
{
"id": 1171566,
"certhash": "ed40cc2e18exxxxxxxxxxxxxxxxxxxx576517139be777153cd9f8ad2d215a9be79",
"keySize": 4096,
"serialNumber": "279f09737fe5dd3d7534be0ea51aff9dc4018501",
"validToDate": "2025-04-06T17:08:40.000+00:00",
"validTo": 1743959320000,
"validFromDate": "2022-04-06T17:08:40.000+00:00",
"validFrom": 1649264920000,
"signatureAlgorithm": "SHA384withRSA",
"extendedValidation": false,
"createdDate": "2024-06-25T09:43:57.000+00:00",
"dn": "OU=US Treasury Root CA, OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"subject": {
"organization": "certificate-view.qualys-test",
"locality": "",
"name": "certificate-view.qualys-test.com, OU=certificate-view, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"state": "",
"country": "US",
"organizationUnit": []
},
"updateDate": "2024-11-19T04:01:14.000+00:00",
"lastFound": 1731988874000,
"imported": true,
"selfSigned": false,
"issuer": {
"organization": "certificate-view.qualys-test",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"type": "Intermediate",
"publicKeyAlgorithm": "",
"revocationStatus": "Not Revoked",
"assets": [
{
"id": 70412578,
"uuid": "abc6d649-ac28-4243-ab8b-131a5955024e",
"netbiosName": "VP0PMEMCASPTRS8",
"name": "certificate-view.qualys-test.com",
"operatingSystem": "Microsoft Windows",
"assetInterfaces": [
{
"hostname": "xxxxxxxx_xxxx_xxxxxxxx",
"address": "xx.xx.xx.xx"
}
],
"primaryIp": "xx.xx.xx.xx",
"created": "2025-07-31T09:55:24.000+00:00",
"updated": "2025-08-05T17:43:33.000+00:00",
"hostInstances": [
{
"id": 33248222,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "F",
"pqcSupportedAlgorithms": [
"X25519MLKEM768"
]
}
]
}
]
},
{
"id": 4216208,
"certhash": "9bf8ecxxxxxxxxxxxxxxxxxxxxxfe948480227c06c93e56307ec92dad2755a214",
"keySize": 2048,
"serialNumber": "6241a969",
"validToDate": "2025-07-20T12:22:54.000+00:00",
"validTo": 1753014174000,
"validFromDate": "2022-07-20T11:52:54.000+00:00",
"validFrom": 1658317974000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2024-11-19T04:01:14.000+00:00",
"dn": "CN=certificate-view.qualys-test, OU=Devices, OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"subject": {
"organization": "certificate-view.qualys-test",
"locality": "",
"name": "certificate-view.qualys-test",
"state": "",
"country": "US",
"organizationUnit": []
},
"updateDate": "2024-11-19T04:01:14.000+00:00",
"lastFound": 1731988874000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "certificate-view.qualys-test",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com""OU=OCIO CA, OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"country": "US",
"state": "",
"certhash": "8a9xxxxxxxxxxxxxxxxxxxx654fc849c768010d5a3dec39be9fba51143c1a51f",
"locality": ""
},
"rootissuer": {
"organization": "certificate-view.qualys-test",
"organizationUnit": [
"FPKI"
],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "5f9aecc24616b2191372600dd80f6dd320c8ca5a0ceb7f09c985ebf0696934fc",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"type": "Leaf",
"publicKeyAlgorithm": "RSA",
"revocationStatus": "Not Revoked",
"assets": [
{
"id": 70412578,
"uuid": "abc6d649-ac28-4243-ab8b-131a5955024e",
"netbiosName": "VP0PMEMCASPTRS8",
"name": "certificate-view.qualys-test",
"operatingSystem": "Microsoft Windows",
"assetInterfaces": [
{
"hostname": "xxxxxxxx_xxxx_xxxxxxxx ",
"address": "xx.xx.xx.xx"
}
],
"primaryIp": "xx.xx.xx.xx",
"created": "2025-07-31T09:55:24.000+00:00",
"updated": "2025-08-05T17:43:33.000+00:00",
"hostInstances": [
{
"id": 33248224,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "F",
"pqcSupportedAlgorithms": [
"X25519MLKEM768"
]
}
]
}
]
},
{
"id": 4216209,
"certhash": "8a9axxxxxxxxxxxxxxxxxxxx54fc849c768010d5a3dec39be9fba51143c1a51f",
"keySize": 2048,
"serialNumber": "5ccb31fe",
"validToDate": "2029-06-22T13:44:02.000+00:00",
"validTo": 1876830242000,
"validFromDate": "2019-06-22T13:14:02.000+00:00",
"validFrom": 1561209242000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2024-11-19T04:01:14.000+00:00",
"dn": "OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"subject": {
"organization": "certificate-view.qualys-test",
"locality": "",
"name": "OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"state": "",
"country": "US",
"organizationUnit": []
},
"updateDate": "2024-11-19T04:01:14.000+00:00",
"lastFound": 1731988874000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "certificate-view.qualys-test",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com""OU=certificate-view.qualys-test, OU=Certification Authorities, OU=certificate-view.qualys-test, O=U.S. Government, C=US",
"country": "US",
"state": "",
"certhash": "ed4xxxxxxxxxxxxxxxxxxxx786559576517139be777153cd9f8ad2d215a9be79",
"locality": ""
},
"rootissuer": {
"organization": "certificate-view.qualys-testt",
"organizationUnit": [
"FPKI"
],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "5f9xxxxxxxxxxxxxxxxxxxxdd80f6dd320c8ca5a0ceb7f09c985ebf0696934fc",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"type": "Intermediate",
"publicKeyAlgorithm": "RSA",
"revocationStatus": "Not Revoked",
"assets": [
{
"id": 70412578,
"uuid": "abc6d649-ac28-4243-ab8b-131a5955024e",
"netbiosName": "VP0PMEMCASPTRS8",
"name": "certificate-view.qualys-test.com",
"operatingSystem": "Microsoft Windows",
"assetInterfaces": [
{
"hostname": "xxxxxxxx_xxxx_xxxxxxxx ",
"address": "xx.xx.xx.xx"
}
],
"primaryIp": "xx.xx.xx.xx",
"created": "2025-07-31T09:55:24.000+00:00",
"updated": "2025-08-05T17:43:33.000+00:00",
"hostInstances": [
{
"id": 33248226,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "F",
"pqcSupportedAlgorithms": [
"X25519MLKEM768"
]
}
]
}
]
}
]
Sample 2: Response when the PQC-supported algorithm is not included in API RequestSample 2: Response when the PQC-supported algorithm is not included in API Request
API Request
curl -X 'POST'
'<qualys_base_url>/certview/v2.3/certificates'
-H 'accept: application/json'
-H 'Authorization: Bearer <JWT Token>
-H 'Content-Type: application/json'
-d '{
"filter": {
"filters": [
{
"field": "instance.pqcSupport",
"value": "true",
"operator": "EQUALS"
}
],
"operation": "AND"
},
"pageNumber": 0,
"pageSize": 10,
"includes": [
"ASSET_INTERFACES",
],
"excludeFields": "",
"assetType": "MANAGED"
}
Response
[
{
"id": 4347312,
"certhash": "76exxxxxxxxxxxxxxxxxxxxbf946aad997d5c1c901b3ce513d3d8fadbabe2ab85",
"keySize": 384,
"serialNumber": "00b0573e9173972770dbb487cb3a452b38",
"validToDate": "2027-03-12T23:59:59.000+00:00",
"validTo": 1804895999000,
"validFromDate": "2024-03-13T00:00:00.000+00:00",
"validFrom": 1710288000000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-09-10T06:39:51.000+00:00",
"dn": "CN=certificate-view.qualys-test.com, O=certificate-view.qualys-test, C=US",
"subject": {
"organization": "certificate-view.qualys-test",
"locality": "",
"name": "certificate-view.qualys-test.com",
"state": "",
"country": "US",
"organizationUnit": []
},
"updateDate": "2025-10-08T09:53:34.000+00:00",
"lastFound": 1759917214000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "certificate-view.qualys-test",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "96bcecxxxxxxxxxxxxxxxxxxxx28c5a7cfe8a3c0aae11a8ffcee05c0bddf08c6",
"locality": ""
},
"rootissuer": {
"organization": "Internet Security Research Group",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "96bcecxxxxxxxxxxxxxxxxxxxx28c5a7cfe8a3c0aae11a8ffcee05c0bddf08c6",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"type": "Intermediate",
"publicKeyAlgorithm": "EC",
"revocationStatus": "Not Revoked",
"assets": [
{
"id": 77714122,
"uuid": "b2220f0a-4b01-436d-b183-96228153bbd2",
"netbiosName": "",
"name": "certificate-view.qualys-test.com",
"operatingSystem": "SUSE Linux Enterprise Server 15 SP3",
"assetInterfaces": [
{
"hostname": "xx.xx.xxxx.xxx.xxxxxx.xx-xxxxxxx.com",
"address": "xxx.xxx.xxx.xxx"
}
],
"primaryIp": "xxx.xxx.xxx.xxx",
"created": "2025-09-25T10:45:13.000+00:00",
"updated": "2025-10-08T09:59:39.000+00:00",
"hostInstances": [
{
"id": 36509521,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "A-",
"pqcSupport": true
}
]
}
]
}
]
Sample 3: Response when the PQC-supported algorithm is included in API RequestSample 3: Response when the PQC-supported algorithm is included in API Request
API Request
curl -X 'POST'
'<qualys_base_url>/certview/v2.3/certificates'
-H 'accept: application/json'
-H 'Authorization: Bearer <JWT Token>
-H 'Content-Type: application/json'
-d '{
"filter": {
"filters": [
{
"field": "instance.pqcSupport",
"value": "true",
"operator": "EQUALS"
}
],
"operation": "AND"
},
"pageNumber": 0,
"pageSize": 10,
"includes": [
"PQC_SUPPORTED_ALGORITHMS",
],
"excludeFields": "",
"assetType": "MANAGED"
}
Response
[
{
"id": 4347312,
"certhash": "76e9exxxxxxxxxxxxxxxxxxxx946aad997d5c1c901b3ce513d3d8fadbabe2ab85",
"keySize": 384,
"serialNumber": "00b0573e9173972770dbb487cb3a452b38",
"validToDate": "2027-03-12T23:59:59.000+00:00",
"validTo": 1804895999000,
"validFromDate": "2024-03-13T00:00:00.000+00:00",
"validFrom": 1710288000000,
"signatureAlgorithm": "SHA256withRSA",
"extendedValidation": false,
"createdDate": "2025-09-10T06:39:51.000+00:00",
"dn": "CN=certificate-view.qualys-test.com, O=certificate-view.qualys-test, C=US",
"subject": {
"organization": "certificate-view.qualys-test",
"locality": "",
"name": "certificate-view.qualys-test.com",
"state": "",
"country": "US",
"organizationUnit": []
},
"updateDate": "2025-10-08T09:53:34.000+00:00",
"lastFound": 1759917214000,
"imported": false,
"selfSigned": false,
"issuer": {
"organization": "Internet Security Research Group",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "96bcecxxxxxxxxxxxxxxxxxxxx28c5a7cfe8a3c0aae11a8ffcee05c0bddf08c6",
"locality": ""
},
"rootissuer": {
"organization": "Internet Security Research Group",
"organizationUnit": [],
"name": "certificate-view.qualys-test.com",
"country": "US",
"state": "",
"certhash": "96bcecxxxxxxxxxxxxxxxxxxxx28c5a7cfe8a3c0aae11a8ffcee05c0bddf08c6",
"locality": ""
},
"issuerCategory": "unapproved",
"instanceCount": 1,
"assetCount": 1,
"sources": [
"VM"
],
"type": "Intermediate",
"publicKeyAlgorithm": "EC",
"revocationStatus": "Not Revoked",
"assets": [
{
"id": 77714122,
"uuid": "b2220f0a-4b01-436d-b183-96228153bbd2",
"netbiosName": "",
"name": "certificate-view.qualys-test.com",
"operatingSystem": "SUSE Linux Enterprise Server 15 SP3",
"primaryIp": "xxx.xxx.xxx.xxx",
"created": "2025-09-25T10:45:13.000+00:00",
"updated": "2025-10-08T09:59:39.000+00:00",
"hostInstances": [
{
"id": 36509521,
"port": 443,
"fqdn": "",
"protocol": "tcp",
"service": "https",
"grade": "A-",
"pqcSupport": true,
"pqcSupportedAlgorithms": [
"MLKEM512"
]
}
]
}
]
}