Skip to main content

List codesigning certificates

POST https://daas.digicert.com/apicontroller/v1/certificate/codesigning/list

Use this endpoint to get a list of all the codesigning certificates available after you run a Discovery scan.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

accountId

required

string

Account ID.

searchCriteriaList

optional

array

Filter results by specified values. The array includes key, operation and value. For definitions, see the Filter options for searchCriteriaList table below.

Example:

searchCriteriaList:[
  {
    "key":"status",
    "operation":"EQUALS",
    "value":["EXPIRED"]
  }
]

divisionIds

required

array

User's division IDs.

startIndex

optional

integer

Index of the first result.

Default: 1

pageSize

optional

integer

Number of records per page.

Allowed values: 0 to 512

Default: 50

filterSelected

required

string

The value to show in the results for each codesigning certificate that meets the search criteria.

Default: thumbprint

Allowed values: thumbprint, username, ipaddress, divisionName, ipCountry.

sortedColumnId

optional

string

Sort results by specified parameter.

Default: thumbprint

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

error

object

Includes error codes, if any.

data

object

Object with information about the filter results.

.. totalCount

integer

Total number of keys based on the filter criteria.

.. currentCount

integer

Number of records on current page.

.. certificates

array

Container for codesigning certificate details.

.. .. thumbprint

string

Thumbprint details associated with the certificate.

.. .. serialNumber

string

Serial number assigned to the certificate on issuance.

.. .. filepath

string

The file path from where the certificate is discovered.

.. .. signingTime

integer

Time when the certificate was signed.

.. .. validFrom

string

Validity start date.

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: 1596781119000

.. .. expiryDate

integer

Validity end date

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: 1596781119000

.. .. org

string

Organization name on the certificate.

.. .. cn

string

Common name on the certificate.

.. .. orgunit

string

Organization unit on the certificate.

.. .. city

string

Organization unit on the certificate.

.. .. state

string

State on the certificate.

.. .. country

string

Country on the certificate.

.. .. ca

string

Certificate Authority that issued the certificate.

.. .. subject

string

Full certificate distinguished name.

.. .. issuer

string

Root certificate that the certificate was issued from.

.. .. firstDiscoveredDate

integer

Date certificate 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: 1596781119000

.. .. lastDiscoveredDate

integer

Date certificate was last found by CertCentral Discovery scan.

.. .. keyAlgo

string

Encryption algorithm for the certificate's key.

.. .. keyLength

integer

Encryption key size for the certificate.

.. .. sigAlgo

string

Signing algorithm used.

.. .. certStatus

string

Status of the certificate found on the endpoint.

.. .. certStatusError

string

Errors retrieving certificate status.

.. .. tags

string

Custom tags added by certificate owner, subscriber, or other admin.

.. .. renewalEmailPreference

boolean

Whether renewal email preference is enabled or not.

Default: true

.. .. emailAddresses

string

Email address for the contact associated with the certificate.

.. .. source

string

The scan used to identify the certificate.

Possible values: agent, sensor.

.. .. serverHost

string

The server host associated with the key.

.. .. binaryFilePath

boolean

Binary file path to the certificate.

Values are comma-separated.

Filter options for searchCriteriaList

The array includes key, operation and value.

Key

Operation

Value

scanName

EQUALS

Name of the scan

status

EQUALS

Status of the scan

org

EQUALS

Organization name

serialNumber

EQUALS

Certificate serial number

ca

EQUALS

Certificate authority

source

EQUALS

Source used for the scan

serverHost

EQUALS

Server host associated with the certificate

filePath

EQUALS

File path from where the certificate is discovered

thumbprint

EQUALS

Certificate thumbprint