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
Request parameters
Name | Req/Opt | Type | Description |
---|---|---|---|
searchCriteriaList | optional | array | Get records for specified criteria. |
.. key | optional | string | Search parameter. Allowed values: |
.. operation | optional | string | Search operation. Allowed value: |
.. value | optional | array | Search values. |
accountId | required | string | Account ID. |
divisionIds | optional | array | Division IDs. |
startIndex | optional | integer | Start at the specified index. Default: |
pageSize | optional | integer | Number of records per page. Default: Max: |
sortedColumnId | optional | string | Sort results by specified parameter. Allowed values: Default: |
sortOrder | optional | string | Sort direction. Allowed values: Default: |
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 |
.. .. 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: |
.. .. 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: |
.. .. 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. |