List CertView Certificates (v2)

Use this API to retrieve certificates. You can use various filters to search the required result. You can use multiple filters and parameters. We have updated the limit for fetching the certificates.

 You can see only those assets that have been assigned by your manager user. When you send an API request, you can access information about the assets and their corresponding certificates assigned to you, based on scope. For more information on tag-based user scoping refer to Certificate View Online help.

POST/certview/v2/certificates

If you need to fetch certificate search results that exceed 10000 certificates, you can use this v2 version of List CertView Certificate API. The response contains certificate details, including associated host information and SSL/TLS related vulnerabilities and grades.

Input ParametersInput Parameters

Parameter

Mandatory/Optional

Data Type

Description

filter 

Optional String

 Filter the events list by providing a query using

Qualys syntax. If you do not provide filter parameter, it shows details of all the certificates.

For the list of tokens you can use to build the query refer to Search tokens and supported format.

pageNumber 

Optional Integer

The page to be returned. The default value is zero.

pageSize 

Optional Integer

Provide the number of records per page to be included in the response.

Default: 10

Maximum: 200

For example, the total result set is 50 assets. If the page size is specified as 10, then the result is divided in 5 pages with 10 assets each.

includes 

Optional String

Includes the specified parameters in the response

For example- ASSET_INTERFACES, VULNERABILITIES, SSL_PROTOCOLS, CIPHER_SUITES, ASSET_TAGS, EXTENSIVE_CERTIFICATE_INFO, ASSET_ACTIVATION_MODULE, ASSET_DOMAIN, ASSET_SUBDOMAIN, ASSET_INVENTORY, ASSET_BUSINESS_APP, ASSET_HARDWARE, and ASSET_OPERATING_SYSTEM

excludeFields Optional String

Exclude the specified parameters from the response.


For example- certificate.certhash, certificate.keySize, asset.netbiosName, asset.uuid.

Note: You can exclude multiple fields in the same query by using comma-separated field names. For more details, refer to the the Compatible tokens, date formats and supported operators 

assetType Optional String

Fetch the certificates based on type of asset specified in the query. You can provide the asset type as MANAGED, UNMANAGED, or ALL.

Default: MANAGED

Managed: Fetches all the certificates that are detected on managed assets.

Unmanaged: Fetches all the certificates discovered on assets with unmanaged tags.

All: Fetches all the certificates discovered on managed and unmanaged assets.

Authorization 

Mandatory String

Authorization token to authenticate to the Qualys Cloud Platform.

Prepend token with "Bearer" and one space.

For example - Bearer authToken

Notes: While creating your query, ensure the following:

Sample with a Single Filter and a ParameterSample with a Single Filter and a Parameter

The following sample request specifies page size as 10 and filter as certificate.id and includes the parameter as ASSET_INTERFACES in the request. The request fetches all certificates related to this query. The response has certificate details and related asset and instance summary.

API Request

curl -X POST  
"<qualys_base_url>/certview/v2/certificates" -H "Accept: application/json" -H "Content-Type: application/json" -d "{\"filter\":{\"filters\":[{\"field\":\"certificate.id\",\"value\":\"string\",\"operator\":\"IS_NOT_EMPTY\"}],\"operation\":\"AND\"},\"pageNumber\":0,\"pageSize\":10,\"includes\":[\"ASSET_INTERFACES\"]}" -H "Authorization: Bearer <JWT Token>"
    

Response

[
    {
        "id": 30029,
        "certhash": "192a86240c5ec5d87dd108f17e2543e78439101f193c99c53193f60d115b885d",
        "keySize": 2048,
        "serialNumber": "05e2ad055846148575bc6476367916b7",
        "validToDate": "2024-02-13T23:59:59.000+00:00",
        "validTo": 1707868799000,
        "validFromDate": "2023-02-13T00:00:00.000+00:00",
        "validFrom": 1676246400000,
        "signatureAlgorithm": "SHA256withRSA",
        "extendedValidation": true,
        "createdDate": "2023-03-29T11:16:15.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": "2023-03-31T10:01:05.000+00:00",
        "lastFound": 1680256865000,
        "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": "DigiCert SHA2 Extended Validation Server CA",
        "instanceCount": 2,
        "assetCount": 2,
        "sources": [
            "VM",
            "QAGENT"
        ],
        "assets": [
            {
                "id": 21045704,
                "uuid": "646c7aa5-cfdc-4294-bea7-xxxxxac03f4",
                "netbiosName": "",
                "name": "www.qualys.com",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6404,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            },
            {
                "id": 17785749,
                "uuid": "99fxxxxx-4c11-49e1-8898-82e9982b0710",
                "netbiosName": "",
                "name": "qualys.com",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6442,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "assetInterfaces": [
                    {
                        "hostname": "qualys.com",
                        "address": "64.39.xx.xxx"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            }
        ]
    }
]
    

Sample with Multiple Filters and Multiple ParametersSample with Multiple Filters and Multiple Parameters

The following sample request specifies page size as 10 and two filters as certificate.id , certificate.hash and includes the parameters as ASSET_INTERFACES and ASETS_TAGS in the request; the request fetches all certificates related to this query. The response has certificate details and related asset and instance summary.

API Request

curl -X POST 
"<qualys_base_url>/certview/v2/certificates" -H "Accept: application/json" -H "Content-Type: application/json" -d {\"filter\":{\"filters\":[{\"field\":\"certificate.id\",\"value\":\"string\",\"operator\":\"IS_NOT_EMPTY\"},{\"field\":\"certificate.certhash\",\"value\":\"466dc3a5d7e15c4c4d518eb910f92c968e26f6d0f00dd77df04c2b4a163ec71e\",\"operator\":\"EQUALS\"}],\"operation\":\"AND\"},\"pageNumber\":0,\"pageSize\":10,\"includes\":[\"ASSET_INTERFACES\",\"ASSET_TAGS\"]}" -H "Authorization: Bearer <JWT Token>"
    

Response

    [
    {
        "id": 30029,
        "certhash": "192a86240c5ec5d87dd108f17e2543e78439101f193c99c53193f60d115b885d",
        "keySize": 2048,
        "serialNumber": "05e2ad055846148575bc6476367916b7",
        "validToDate": "2024-02-13T23:59:59.000+00:00",
        "validTo": 1707868799000,
        "validFromDate": "2023-02-13T00:00:00.000+00:00",
        "validFrom": 1676246400000,
        "signatureAlgorithm": "SHA256withRSA",
        "extendedValidation": true,
        "createdDate": "2023-03-29T11:16:15.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": "2023-03-31T10:01:05.000+00:00",
        "lastFound": 1680256865000,
        "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": "DigiCert SHA2 Extended Validation Server CA",
        "instanceCount": 2,
        "assetCount": 2,
        "sources": [
            "VM",
            "QAGENT"
        ],
        "assets": [
            {
                "id": 21045704,
                "uuid": "646c7aa5-cfdc-4294-bea7-d43664ac03f4",
                "netbiosName": "",
                "name": "www.qualys.com",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6404,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            },
            {
                "id": 17785749,
                "uuid": "99f29795-4c11-49e1-8898-82e9982b0710",
                "netbiosName": "",
                "name": "qualys.com",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6442,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "assetInterfaces": [
                    {
                        "hostname": "qualys.com",
                        "address": "64.39.xx.xxx"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            }
        ]
    }
]

Sample with a Single Filter and a Parameter as DateSample with a Single Filter and a Parameter as Date

The following sample request specifies filter as certificate.validFromDate and includes the parameter as date in the request. The request fetches all certificates related to this query. The response has certificate details and related asset and instance summary.

API Request

curl -X POST 
"<qualys_base_url>/certview/v2/certificates" -H "accept: application/json" -H ""Content-Type: application/json" -d "{\"filter\":{\"filters\":[{\"field\":\"certificate.validFromDate\",\"value\":\"2022-09-22 00:00:00\",\"operator\":\"GREATER_THAN_EQUAL\"}],\"operation\":\"AND\"},\"pageNumber\":0,\"pageSize\":1,\"includes\":[\"ASSET_INTERFACES\"]}" -H "Authorization: Bearer <JWT Token>"
    

Response

    [
    {
        "id": 30029,
        "certhash": "192a86240c5ec5d87dd108f17e2543e78439101f193c99c53193f60d115b885d",
        "keySize": 2048,
        "serialNumber": "05e2ad055846148575bc6476367916b7",
        "validToDate": "2024-02-13T23:59:59.000+00:00",
        "validTo": 1707868799000,
        "validFromDate": "2023-02-13T00:00:00.000+00:00",
        "validFrom": 1676246400000,
        "signatureAlgorithm": "SHA256withRSA",
        "extendedValidation": true,
        "createdDate": "2023-03-29T11:16:15.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": "2023-03-31T10:01:05.000+00:00",
        "lastFound": 1680256865000,
        "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": "DigiCert SHA2 Extended Validation Server
CA","instanceCount": 2,
        "assetCount": 2,
        "sources": [
            "VM",
            "QAGENT"
        ],
        "assets": [
            {
                "id": 21045704,
                "uuid": "646c7aa5-cfdc-4294-bea7-d43664ac03f4",
                "netbiosName": "",
                "name": "www.qualys.com",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6404,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            },
            {
                "id": 17785749,
                "uuid": "99f29795-4c11-49e1-8898-82e9982b0710",
                "netbiosName": "",
                "name": "qualys.com",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6442,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "assetInterfaces": [
                    {
                        "hostname": "qualys.com",
                        "address": "64.39.xx.xxx"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            }
        ]
    }
]

Sample with a Single Exclude FilterSample with a Single Exclude Filter

The following sample request specifies page size as 10 and filter as certificate.id and includes the parameter as ASSET_INTERFACES and exclude field parameter as certificate.subject the request. The request fetches all certificates related to this query. The response has certificate details and related asset and instance summary but excludes certificate subject field.

API Request

curl -X 'POST'
"<qualys_base_url>/certview/v2/certificates' \
  -H 'accept: application/json'-H 'Authorization: Bearer  \
  -H 'Content-Type: application/json' -d '{"filter": {
    "filters": [{"field": "certificate.id","value": "6677", "operator": "CONTAINS"}],"operation": "AND"},"pageNumber": 0, "pageSize": 10,"includes": ["ASSET_INTERFACES"],"excludeFields": "certificate.subject"}"
    

Response

[
    {
        "id": 30029,
        "certhash": "192a86240c5ec5d87dd108f17e2543e78439101f193c99c53193f60d115b885d",
        "keySize": 2048,
        "serialNumber": "05e2ad055846148575bc6476367916b7",
        "validToDate": "2024-02-13T23:59:59.000+00:00",
        "validTo": 1707868799000,
        "validFromDate": "2023-02-13T00:00:00.000+00:00",
        "validFrom": 1676246400000,
        "signatureAlgorithm": "SHA256withRSA",
        "extendedValidation": true,
        "createdDate": "2023-03-29T11:16:15.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": "2023-03-31T10:01:05.000+00:00",
        "lastFound": 1680256865000,
        "imported": false,
        "selfSigned": false,
        "issuer": {
            "organization": "DigiCert Inc",
            "organizationUnit": [
                "www.digicert.com"
            ],
            "name": "DigiCert SHA2 Extended Validation Server CA",
            "country": "US",
            "state": "",
            "locality": ""
        },
        "rootissuer": {
            "organization": "DigiCert Inc",
            "organizationUnit": [
                "www.digicert.com"
            ],
            "name": "DigiCert High Assurance EV Root CA",
            "country": "US",
            "state": "",
            "certhash": "7431e5f4c3c1ce4690774f0b61e05440883ba9a01ed00ba6abd7806ed3b118cf",
            "locality": ""
        },
        "issuerCategory": "DigiCert SHA2 Extended Validation Server CA",
        "instanceCount": 2,
        "assetCount": 2,
        "sources": [
            "VM",
            "QAGENT"
        ],
        "assets": [
            {
                "id": 21045704,
                "uuid": "646c7aa5-cfdc-4294-bea7-d43664ac03f4",
                "netbiosName": "",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6404,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            },
            {
                "id": 17785749,
                "uuid": "99f29795-4c11-49e1-8898-82e9982b0710",
                "netbiosName": "",
                "operatingSystem": "NetScaler",
                "hostInstances": [
                    {
                        "id": 6442,
                        "port": 443,
                        "fqdn": "",
                        "protocol": "tcp",
                        "service": "http",
                        "grade": "A"
                    }
                ],
                "assetInterfaces": [
                    {
                        "hostname": "qualys.com",
                        "address": "64.39.xx.xxx"
                    }
                ],
                "primaryIp": "64.39.xx.xxx"
            }
        ]
    }
]

Sample to View Certificates on the Assets with Tag NameSample to View Certificates on the Assets with Tag Name

API Request

curl -X POST
"<qualys_base_url>/certview/v2/certificates" \
-H "accept":"application/json" \
-H "Content-Type: application/json"\
-d "{ \"filter\": { \"filters\": [{ \"field\":
\"asset.tagName\",\"value\": \"Internet Facing Assets\",
\"operator\": \"EQUALS\"},\"operation\": \"AND\" },
\"pageNumber\": 0,\"pageSize\": 10, \"includes\": [ \"ASSET_TAGS\" ]}"
-H "Authorization: Bearer <JWT Token>"
    

Response

{
    "id":206013,
    "certhash":"331ba3783f4b31ce73ad3b9cc61de4fcad1670be594bf59fd9062bfc531b9
014",
    "keySize":2048,
    "serialNumber":"072e05df5afde328abb850de4be48f4b",
    "validToDate":"2024-09-13T23:59:59.000+00:00",
    "validTo":1726271999000,
    "validFromDate":"2023-09-14T00:00:00.000+00:00",
    "validFrom":1694649600000,
    "signatureAlgorithm":"SHA256withRSA",
    "extendedValidation":false,
    "createdDate":"2023-10-10T11:19:49.000+00:00",
    "dn":"CN=www.qualys.com, O=\"Qualys, Inc.\", L=Foster City,
ST=California, C=US",
    "subject":{
        "organization":"Qualys, Inc.",
        "locality":"Foster City",
        "name":"www.qualys.com",
        "state":"California",
        "country":"US",
        "organizationUnit":[
            
        ]
    },
    "updateDate":"2023-12-04T05:22:44.000+00:00",
    "lastFound":1701667364000,
    "imported":false,
    "selfSigned":false,
    "issuer":{
        "organization":"DigiCert Inc",
        "organizationUnit":[
            
        ],
        "name":"DigiCert Global G2 TLS RSA SHA256 2020 CA1",
        "country":"US",
        "state":"",
        "certhash":"cb3ccbb76031e5e0138f8dd39a23f9de47ffc35e43c1144cea27d46a5ab1c
b5f",
        "locality":""
    },
    "issuerCategory":"unapproved",
    "instanceCount":1,
    "assetCount":1,
    "sources":[
        "VM"
    ],
    "assets":[
        {
            "id":15741703,
            "uuid":"14994e8c-cc2d-408f-8950-c135f50fb6e0",
            "netbiosName":"SYS_2_2_2_2",
            "name":"2.2.2.2",
            "operatingSystem":"EulerOS / SuSE Linux / Scientific Linux",
            "hostInstances":[
                {
                    "id":175003,
                    "port":443,
                    "fqdn":"",
                    "protocol":"tcp",
                    "service":"http",
                    "grade":"C"
                }
            ],
            "tags":[
                {
                    "name":"yyyyyyyyy\"&gt;&lt;img&gt;",
                    "uuid":"9808bdb4-4968-41f2-8527-6108ae985a90"
                },
                {
                    "name":"Internet Facing Assets",
                    "uuid":"db344697-10b9-48a0-bcc2-fbd8a8f79077"
                }
            ],
            "primaryIp":"2.2.2.2"
        }
    ]
}
]

Sample to View Unmanaged AssetsSample to View Unmanaged Assets

In the following API request, source is specified as EASM and asset type as unmanaged. The response displays the Shodan scanned certificates from unmanaged assets.

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": "certificate.source",
"value": "EASM","operator": "EQUALS" } ],"operation": "AND"},
"pageNumber": 0, "pageSize": 10, "includes": ["ASSET_ACTIVATION_MODULE",
"ASSET_DOMAIN", "ASSET_SUBDOMAIN", "ASSET_INVENTORY",
"ASSET_ORGANIZATION" ], "assetType": "UNMANAGED"}'
    

Response

[
    {
        "id":117250,
        "certhash":"edb3a1xxxxxx7e9fxxxxxx0872eexxxxxxd1ac55dxxxx3234ff93dxxxxxx2
15",
        "keySize":2048,
        "serialNumber":"02af67d257cff78892c990b5f83ee393",
        "validToDate":"2024-02-27T23:59:59.000+00:00",
        "validTo":1709078399000,
        "validFromDate":"2023-02-28T00:00:00.000+00:00",
        "validFrom":1677542400000,
        "signatureAlgorithm":"SHA256withRSA",
        "extendedValidation":false,
        "createdDate":"1970-01-01T00:00:00.000+00:00",
        "dn":"CN=ssllabs.com, O="Qualys, Inc.\", L=Foster City,
ST=California, C=US",
        "subject":{
            "organization":"Qualys, Inc.",
            "locality":"Foster City",
            "name":"ssllabs.com",
            "state":"California",
            "country":"US",
            "organizationUnit":[
                
            ]
        },
        "imported":true,
        "selfSigned":false,
        "issuer":{
            "organization":"DigiCert Inc",
            "organizationUnit":[
                
            ],
            "name":"DigiCert TLS RSA SHA256 2020 CA1",
            "country":"US",
            "state":"",
            "certhash":"52274c57ce4dee3b49xxxxxxxxxxxxxxxxx1898b3be88725axxxxxxxxxx2f
e14",
            "locality":""
        },
        "rootissuer":{
            "organization":"DigiCert Inc",
            "organizationUnit":[
                "
www.digicert.com"
            ],
            "name":"DigiCert Global Root CA",
            "country":"US",
            "state":"",
            "certhash":"4348a0e9444c78cb26xxxxxxxxxxxxxxxxxf9662bx2xxxxxxxxxxxxxxxxx1
61",
            "locality":""
        },
        "issuerCategory":"unapproved",
        "instanceCount":1,
        "assetCount":1,
        "sources":[
            "EASM",
            "VM"
        ],
        "assets":[
            {
                "id":37094759,
                "uuid":"2fexxxxx-3ee8-xxxx-bd03-9xxxxxb2509f",
                "netbiosName":"",
                "name":"networking4all.ssllabs.com",
                "hostInstances":[
                    {
                        "id":107227,
                        "port":8443,
                        "fqdn":"",
                        "protocol":"tcp",
                        "service":"https",
                        "grade":"N/A"
                    }
                ],
                "assetInterfaces":[
                    {
                        "hostname":null,
                        "address":"64.xx.xx.xx"
                    }
                ],
                "primaryIp":"64.xx.xx.xx",
                "domain":[
                    "ssllabs.com"
                ],
                "subdomain":[
                    "networking4all.ssllabs.com",
                    "entrust.ssllabs.com",
                    "secure128.ssllabs.com",
                    "wosign.ssllabs.com",
                    "globalsign.ssllabs.com",
                    "www.ssllabs.com",
                    "trustzone.ssllabs.com",
                    "akamai.ssllabs.com",
                    "biznet.ssllabs.com",
                    "plaintext.ssllabs.com",
                    "globaltrust.ssllabs.com",
                    "comodo.ssllabs.com",
                    "clienttest.ssllabs.com",
                    "ota.ssllabs.com",
                    "casecurity.ssllabs.com",
                    "api.ssllabs.com",
                    "geocerts.ssllabs.com"
                ],
                "inventory":[
                    {
                        "source":"EASM",
                        "firstSeen":1709195100000,
                        "lastSeen":1711605116000
                    },
                    {
                        "source":"IP Scanner",
                        "firstSeen":1705580750000,
                        "lastSeen":1705580361000
                    }
                ],
                "activatedForModules":[
                    "VM"
                ],
                "organizationNames":[
                    "SSL Labs"
                ]
            }
        ]
    }
]

Sample to View Managed AssetsSample to View Managed Assets

In the following API request, asset type is specified as managed. The response displays the certificates from managed assets.

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.name",
"value": "badssl.com",
"operator": "EQUALS"
}
],
"operation": "AND"
},
"pageNumber": 0,
"pageSize": 10,
"includes": [
"ASSET_INTERFACES"
],
"assetType": "MANAGED"
}’"
    

Response

[
    {
        "id":32810614,
        "certhash":"b4dxxxxx1b778exxxxx565xxxxx47db722a33a231ee7dxxxxx3785160dxxxxx3",
        "keySize":2048,
        "serialNumber":"038d399dce3f272a52aa08671d7603ff3741",
        "validToDate":"2024-05-21T20:27:19.000+00:00",
        "validTo":1716323239000,
        "validFromDate":"2024-02-21T20:27:20.000+00:00",
        "validFrom":1708547240000,
        "signatureAlgorithm":"SHA256withRSA",
        "extendedValidation":false,
        "createdDate":"2024-03-14T05:02:53.000+00:00",
        "dn":"CN=*.badssl.com",
        "subject":{
            "organization":"",
            "locality":"",
            "name":"*.badssl.com",
            "state":"",
            "country":"",
            "organizationUnit":[
                
            ]
        },
        "updateDate":"2024-03-14T05:02:53.000+00:00",
        "lastFound":1710392573000,
        "imported":false,
        "selfSigned":false,
        "issuer":{
            "organization":"Let's Encrypt",
            "organizationUnit":[
                
            ],
            "name":"R3",
            "country":"US",
            "state":"",
            "certhash":"67add1xxxxx20ae61bxxxxx6813c04c2aaxxxxx0796865572a3cxxxxx613dfd",
            "locality":""
        },
        "rootissuer":{
            "organization":"Internet Security Research Group",
            "organizationUnit":[
                
            ],
            "name":"ISRG Root X1",
            "country":"US",
            "state":"",
            "certhash":"96bcecxxxxx976f37xxxxx9acf28c5a7cfe8a3c0aae11xxxxxxee05c0xxxxx8c6",
            "locality":""
        },
        "issuerCategory":"unapproved",
        "instanceCount":1,
        "assetCount":1,
        "sources":[
            "VM"
        ],
        "assets":[
            {
                "id":974772657,
                "uuid":"0465818d-987d-45bc-ab13-364f2d509e37",
                "netbiosName":"",
                "name":"badssl.com",
                "hostInstances":[
                    {
                        "id":37446944,
                        "port":443,
                        "fqdn":"",
                        "protocol":"tcp",
                        "service":"http",
                        "grade":"C"
                    }
                ],
                "assetInterfaces":[
                    {
                        "hostname":"badssl.com",
                        "address":"104.xx.xx.1xx"
                    }
                ],
                "primaryIp":"104.xx.xx.xx5"
            }
        ]
    }
]