Analyze Certificate API

Use these API functions to analyze information based on host or IP.

Use this API to retrieve the list of endpoints that are associated with an FQDN in the CertView inventory

Analyze Certificate Information

POST/certview/v1/analyze

Input ParametersInput Parameters

Parameter	Mandatory/Optional	Data Type	Description
host	Mandatory	String	Host on which scan is executed, it can be IP For example - www.ssllabs.com, 10.10.10.10
Authorization	Mandatory	String	Authorization token to authenticate to the Qualys Cloud Platform. Prepend token with "Bearer" and one space. For example - Bearer authToken

Parameter

Mandatory/Optional

Data Type

Description

host

Mandatory

String

Host on which scan is executed, it can be IP

For example - www.ssllabs.com, 10.10.10.10

Authorization

Mandatory

String

Authorization token to authenticate to the Qualys Cloud Platform.

Prepend token with "Bearer" and one space.

For example - Bearer authToken

Sample - Host is IPSample - Host is IP

API Request

curl-X POST 
"<qualys_base_url>/certview/v1/analyze" -H "Accept: application/json" 
-H "Content-Type: application/json" -d "{\"host\":\"XXX.XXX.XXX.XXX\"}" 
-H "Authorization: Bearer <JWT Token>"

Response

{
  "host": "XXX.XXX.XXX.XXX",
  "endpoints": [
    {
      "ipAddress": "XXX.XXX.XXX.XXX",
      "port": 443,
      "service": "http",
      "serverName": "",
      "grade": "A",
      "gradeTrustIgnored": "A",
      "hasWarnings": false,
      "exceptional": false
    }
  ]
}

Sample - Host is FQDNSample - Host is FQDN

API Request

curl -X 
"<qualys_base_url>/certview/v1/analyze" -H "Accept: application/json" -H "Content-Type: application/json" -d "{\"host\":\"www.qualys.com\"}" -H "Authorization: Bearer <JWT Token>"

Response

{
  "host": "www.qualys.com",
  "endpoints": [
    {
      "ipAddress": "XXX.XXX.XXX.XXX",
      "port": 443,
      "service": "http",
      "serverName": "",
      "grade": "A",
      "gradeTrustIgnored": "A",
      "hasWarnings": false,
      "exceptional": false
    }
  ]
}