Certificate View Release 4.6 API

September 22, 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): Support Added for NOT_EQUALS Operator on asset.tagName

New or Updated API	Updated
API Endpoints	/certview/v2/certificates /certview/v2.1/certificates /certview/v2.2/certificates
Method	POST
DTD or XSD changes	Not Applicable

With this release, the List CertView Certificates (v2) API now supports the NOT_EQUALS operator for the asset.tagName filter when listing certificates. This enhancement provides flexibility when retrieving certificate data by allowing you to exclude specific tags from your query results.

For example,

{
  "field": "asset.tagName",
  "value": "Shodan",
  "operator": "NOT_EQUALS"
}

This query is used in the CertView Public V2 API to filter certificates based on the tags assigned to their associated assets.

field: asset.tagName refers to the tag name applied to the asset linked with the certificate.
value: Shodan refers to the specific tag value you are filtering.
operator: NOT_EQUALS refers to ensuring that certificates linked to assets with the tag Shodan are excluded from the query.

The filter is available to all the versions of the API available: v2, v2.1, v2.2

For more information on input parameters and more samples, refer to the Certificate View API User guide.

Sample: Response to get the details of all the assets excluding Shodan tagSample: Response to get the details of all the assets excluding Shodan tag

API Request

curl -X 'POST'  
'<qualys_base_url>/certview/v2/certificates'   
-H 'accept: application/json'   
-H 'Authorization: Bearer <JWT Token>
-H 'Content-Type: application/json'   
-d'{
"filter": {
"filters": [
{ "field": "asset.tagName", "value": "Shodan", "operator": "NOT_EQUALS" }
,
{ "field": "certificate.serialNumber", "value": "00d193aa9a645420da", "operator": "EQUALS" }
],
"operation": "AND"
},
"pageNumber": 0,
"pageSize": 10,
"includes": [
"ASSET_INTERFACES"
],
"assetType": "MANAGED"
}'

Response

[
    {
        "id":8366,
        "certhash":"13a8cc24ef5f994ea86e190a98d36b435966d43e8001523b63f0c439091b8aa0",
        "keySize":1024,
        "serialNumber":"00d193aa9a645420da",
        "validToDate":"2019-06-27T12:56:00.000+00:00",
        "validTo":1561640160000,
        "validFromDate":"2018-12-09T12:56:00.000+00:00",
        "validFrom":1544360160000,
        "signatureAlgorithm":"SHA256withRSA",
        "extendedValidation":false,
        "createdDate":"2019-03-01T06:55:33.000+00:00",
        "dn":"CN=certificate-view.qualys-test.com, O=Qualys-Test, L=Foster City, ST=California, C=US",
        "subject":{
            "organization":"Qualys-Test",
            "locality":"Foster City",
            "name":"certificate-view.qualys-test.com",
            "state":"California",
            "country":"US",
            "organizationUnit":[
                
            ]
        },
        "updateDate":"2019-03-01T06:55:33.000+00:00",
        "lastFound":1551423333000,
        "imported":true,
        "selfSigned":true,
        "issuer":{
            "organization":"Qualys-Test",
            "organizationUnit":[
                
            ],
            "name":"certificate-view.qualys-test.com",
            "country":"US",
            "state":"California",
            "certhash":"",
            "locality":"Foster City"
        },
        "issuerCategory":"Self-Signed",
        "orderStatus":"Rejected",
        "instanceCount":0,
        "assetCount":0,
        "type":"Leaf",
        "publicKeyAlgorithm":"",
        "revocationStatus":"Scan Pending"
    }
]

Last updated: February, 2026