Skip to main content

List binaries

POST https://daas.digicert.com/apicontroller/v1/binaries/list

Use this endpoint to get a list of all the binaries 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":"algorithm",
    "operation":"EQUALS",
    "value":["AES"]
  }
]

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

Allowed values: algorithm, fileName, filePath, scanName, source, serverHost, isSignedBinarie, fileType, tags, dateSignedOn.

sortedColumnId

optional

string

Sort results by specified parameter.

Default: fileName

sortOrder

optional

string

Sort direction.

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

Default: ASC

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 binaries based on the filter criteria.

.. currentCount

integer

Number of records on current page.

.. cryptoData

array

Container for binaries details.

.. .. fileName

string

Name of the file.

.. .. source

string

The scan used to identify the certificate.

Possible values: agent, sensor.

Note: Possible values are Manual Upload or Cloud scan for server certificates.

.. .. algorithm

string

Hashing algorithm and keysize (or length) in bits of the SSH key.

Possible values: ECDSA SHA2 NISTP256 256, RSA1 1024, RSA1 2048, SSH DSS 1024, SSH RSA 1024, SSH ED25519 256, SSH RSA 2048, SSH RSA 3072, SSH RSA 4096.

.. .. fileType

string

Type of the file

.. .. filePath

string

The file path from where the certificate is discovered.

.. .. tags

string

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

.. .. firstDiscoveredDate

integer

Date binary 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 binary was last found by CertCentral Discovery scan.

.. .. scanName

string

Name of the scan.

.. .. signingTimestamp

integer

Time when the binary was signed.

.. .. isSigned

boolean

Whether the binary file was signed or not.

Deafult: Yes

.. .. serverHost

string

The server host associated with the certificate.

.. .. certThumbprint

string

Thumbprint details associated with the certificate.

.. .. hasFileChanged

boolean

Whether the file has been changed.

Filter options for searchCriteriaList

The array includes key, operation and value.

Key

Operation

Value

algorithm

EQUALS

Hashing algorithm

filename

EQUALS

Name of the file

filePath

EQUALS

Path to the file

scanName

EQUALS

Name of the scan

source

EQUALS

Source used for the scan

serverHost

EQUALS

Server host associated with the certificate

isSignedBinaries

EQUALS

Whether binaries signed

fileType

EQUALS

Type of the file

tags

EQUALS

Custom tags associated

dateSignedOn

EQUALS

Signing date