Skip to main content

List endpoints

POST https://daas.digicert.com/apicontroller/v1/reports/viewIpPort

Get a total count and list of all endpoint servers that have certificates found through CertCentral Discovery scans. Optionally filter results by server or scan attributes.

Example requests and responses

Example 1. cURL
curl -X POST \
  https://daas.digicert.com/apicontroller/v1/reports/viewIpPort \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "searchCriteriaList": [
        {
            "key":"serialNumber",
            "operation": "EQUALS",
            "value": [
                "0eb6eab418c873d8f3c031dcdddf18b0"
            ]
        },
        {
            "key":"ip",
            "operation": "EQUALS",
            "value": [
                "www.itc.com","www.digicert.com","www.cert.com","wmart.com","ph.com"
            ]
        },
        {
            "key":"port",
            "operation": "EQUALS",
            "value": [
                3389,636,443,80,389,8443
            ]
        },
        {
            "key":"scanName",
            "operation": "EQUALS",
            "value": [
                "ScanWithAllVul","GtScdlV612Aug19"
            ]
        },
        {
            "key":"serverSecurity",
            "operation": "EQUALS",
            "value": [
                "NO_VULNERABILITY_FOUND"
            ]
        },
        {
            "key":"isCertPresent",
            "operation": "EQUALS",
            "value": [
                true
            ]
        },
        {
            "key":"cn",
            "operation": "EQUALS",
            "value": [
                "www.origin.digicert.com"
            ]
        }
    ],
    "accountId": "126993",
    "divisionIds": [],
    "startIndex": 1,
    "pageSize": 50,
    "sortedColumnId": null,
    "sortOrder": "ASC"
}'

Example 2. Python
import requests

url = "https://daas.digicert.com/apicontroller/v1/reports/viewIpPort"

payload = "{\n    \"searchCriteriaList\": [\n        {\n            \"key\": \"serialNumber\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"0eb6eab418c873d8f3c031dcdddf18b0\"\n            ]\n        },\n        {\n            \"key\": \"ip\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.itc.com\",\"www.digicert.com\",\"www.cert.com\",\"wmart.com\",\"ph.com\"\n            ]\n        },\n        {\n            \"key\": \"port\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"3389\",\"636\",\"443\",\"80\",\"389\",\"8443\"\n            ]\n        },\n        {\n            \"key\": \"scanName\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"ScanWithAllVul\",\"GtScdlV612Aug19\"\n            ]\n        },\n        {\n            \"key\": \"serverSecurity\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"NO_VULNERABILITY_FOUND\"\n            ]\n        },\n        {\n            \"key\": \"isCertPresent\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"true\"\n            ]\n        },\n        {\n            \"key\": \"cn\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.origin.digicert.com\"\n            ]\n        }\n    ],\n    \"accountId\": \"126993\",\n    \"divisionIds\": [],\n    \"startIndex\": 1,\n    \"pageSize\": 50,\n    \"sortedColumnId\": null,\n    \"sortOrder\": \"ASC\"\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json",
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Example 3. Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://daas.digicert.com/apicontroller/v1/reports/viewIpPort"

	payload := strings.NewReader("{\n    \"searchCriteriaList\": [\n        {\n            \"key\": \"serialNumber\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"0eb6eab418c873d8f3c031dcdddf18b0\"\n            ]\n        },\n        {\n            \"key\": \"ip\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.itc.com\",\"www.digicert.com\",\"www.cert.com\",\"wmart.com\",\"ph.com\"\n            ]\n        },\n        {\n            \"key\": \"port\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"3389\",\"636\",\"443\",\"80\",\"389\",\"8443\"\n            ]\n        },\n        {\n            \"key\": \"scanName\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"ScanWithAllVul\",\"GtScdlV612Aug19\"\n            ]\n        },\n        {\n            \"key\": \"serverSecurity\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"NO_VULNERABILITY_FOUND\"\n            ]\n        },\n        {\n            \"key\": \"isCertPresent\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"true\"\n            ]\n        },\n        {\n            \"key\": \"cn\",\n            \"operation\": \"EQUALS\",\n            \"value\": [\n                \"www.origin.digicert.com\"\n            ]\n        }\n    ],\n    \"accountId\": \"126993\",\n    \"divisionIds\": [],\n    \"startIndex\": 1,\n    \"pageSize\": 50,\n    \"sortedColumnId\": null,\n    \"sortOrder\": \"ASC\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Example 4. NodeJS
var request = require("request");

var options = { method: 'POST',
  url: 'https://daas.digicert.com/apicontroller/v1/reports/viewIpPort',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { searchCriteriaList: 
      [ { key: 'serialNumber', operation: 'EQUALS', value: [ '0eb6eab418c873d8f3c031dcdddf18b0' ] },
        { key: 'ip', operation: 'EQUALS', value: [ 'www.itc.com','www.digicert.com','www.cert.com','wmart.com','ph.com' ] },
        { key: 'port', operation: 'EQUALS', value: [ '3389','636','443','80','389','8443' ] },
        { key: 'scanName', operation: 'EQUALS', value: [ 'ScanWithAllVul','GtScdlV612Aug19' ] },
        { key: 'serverSecurity', operation: 'EQUALS', value: [ 'NO_VULNERABILITY_FOUND' ] },
        { key: 'isCertPresent', operation: 'EQUALS', value: [ 'true' ] },
        { key: 'cn', operation: 'EQUALS', value: [ 'www.origin.digicert.com' ] } ],
     accountId: '126993',
     divisionIds: [],
     startIndex: 1,
     pageSize: 50,
     sortedColumnId: null,
     sortOrder: 'ASC' },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

Request parameters

Name

Req/Opt

Type

Description

searchCriteriaList

optional

array

Get records for specified criteria.

.. key

optional

string

Search parameter.

Allowed values: serialNumber, ip, port, scanName, serverSecurity, isCertPresent, cn

.. operation

optional

string

Search operation.

Allowed value: EQUALS

.. value

optional

array

Search values.

accountId

required

string

Account ID.

divisionIds

optional

array

Division IDs.

startIndex

optional

integer

Start at the specified index.

Default: 1

pageSize

optional

integer

Number of records per page.

Default: 50,

Max: 100

sortedColumnId

optional

string

Sort results by specified parameter.

Allowed values: serialNumber, ip, port, scanName, serverSecurity, isCertPresent, cn

Default: isCertPresent

sortOrder

optional

string

Sort direction.

Allowed values: DESC (descending: 9-0, Z-A), ASC (ascending: 0-9, A-Z)

Default: DESC

Response parameters

Name

Type

Description

data

object

Container.

.. totalCount

integer

Total number of records that match search criteria.

.. currentCount

integer

Number of records on current page.

.. onlineIPPortDetailsDTOList

array

Container for endpoint details.

.. .. commonName

string

Common name of certificate found on the endpoint.

.. .. port

string

Port that the certificate was found on.

.. .. ipAddress

string

IP address of the endpoint.

.. .. portStatus

string

Availability or connection status of the endpoint.

.. .. isCertPresent

bool

Whether or not certificate is installed at the endpoint.

.. .. serverSecurityRating

string

Server security rating, based on the endpoint's communication and security settings.

.. .. service

string

Communication protocol, such as https.

.. .. deviceType

string

General hardware type, if available.

.. .. serverName

string

Server software, if available.

.. .. serverVersion

string

Server version, if available.

.. .. scanId

string

Unique ID for the CertCentral Discovery scan that scanned and retrieved details for the endpoint.

.. .. scanName

string

Friendly name the admin gave to the CertCentral Discovery scan.

.. .. domainName

string

Root domain of the endpoint.

.. .. firstDiscoveredDate

integer

Date endpoint was first found by CertCentral Discovery scan.

Format: epoch in millisecond.

Epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.

Example: 1855828800000

.. .. certificateId

string

Unique DigiCert-generated ID for the certificate found on the endpoint. Use for API requests that require it.

.. .. os

string

Operating system.

.. .. osVersion

string

Operating system version, if available.

.. .. vulnerabilityName

string

Vulnerabilities found based on known endpoint details.

.. .. serverId

string

Server ID that uniquely identifies the record.

.. .. san

string

Subject alternative names on the certificate found on the endpoint.

.. .. org

string

Organization name on the certificate found on the endpoint.

.. .. certExpiryDate

integer

Expiration date of the certificate found on the endpoint.

Format: epoch in millisecond.

Epoch corresponds to 0 hours, 0 minutes, and 0 seconds (00:00:00) Coordinated Universal Time (UTC) on a specific date, which varies from system to system.

Example: 1855828800000

.. .. certStatus

string

Status of the certificate found on the endpoint.

.. .. certRating

string

Certificate security rating, based on industry standards and the certificate's settings.

.. .. ca

string

Certificate Authority that issued the certificate.

.. .. serialNumber

string

Serial number assigned to the certificate on issuance.

In this section: