Skip to main content

Get binary details

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

Use this endpoint to get information about binaries.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

accountId

required

string

Account ID.

filePath

required

string

The file path from where the binary is discovered.

serverHost

required

string

The server host associated with the binary.

Response parameters

Name

Type

Description

error

object

Includes error codes, if any.

data

object

Object with information about the codesigning certificate.

.. fileName

string

Name of the file associated with the binary.

.. source

string

The scan used to identify the certificate.

Possible values: agent, sensor.

.. 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 file.

.. filepath

string

The file path from where the binary 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

string

Whether the binary is signed or not.

.. serverHost

string

The server host associated with the key.

Values are comma-separated.

.. certThumbprint

List of string

Thumbprint of signing certificates associated with the binary.

.. hasFileChanged

boolean

Whether the file changed after the scan run.