List binaries

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

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

cURL
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/certificate/binaries/list' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw 
'{
    "accountId": 5153184,
    "searchCriteriaList": [{
        "key": "algorithms",
        "operation": "EQUALS",
        "value": ["AES"]
    }],
    "divisionIds": [],
    "startIndex": 1,
    "pageSize": 50,
    "filterSelected": "fileName",
    "sortedColumnId": "fileName",
    "sortOrder": "ASC"
}'
200 OK
{
    "error": null,
    "data": {
        "totalCount": 1672,
        "currentCount": 50,
        "cryptoData": [{
            "fileName": "101",
            "source": "Agent",
            "algorithms": ["AES"],
            "fileType": "EXE (Windows)",
            "filePath": "C:\\Program Files (x86)\\Google\\Update\\Download\\{8A69D345-D564-463C-AFF1-A69D9E530F96}\\101.0.4951.54\\101.0.4951.54_100.0.4896.127_chrome_updater.exe",
            "tags": "",
            "firstDiscoveredDate": 1651999189088,
            "lastDiscoveredDate": 1652025889876,
            "scanName": null,
            "signingTimestamp": 1651418120000,
            "isSigned": "Yes",
            "serverHost": "win93ca",
            "certThumbprint": ["2673ea6cc23beffda49ac715b121544098a1284c"],
            "hasFileChanged": false
        }, {
            "fileName": "atse64",
            "source": "Agent",
            "algorithms": ["AES"],
            "fileType": "DLL",
            "filePath": "C:\\ProgramData\\Trend Micro Installer\\Trend_Micro_1566209067\\Setup64\\AMSP\\update\\engine\\c2t1207960067l-1p5889r-1o-1\\11.000.1003\\atse64.dll",
            "tags": "",
            "firstDiscoveredDate": 1651999604931,
            "lastDiscoveredDate": 1652026315424,
            "scanName": null,
            "signingTimestamp": 1530612109000,
            "isSigned": "Yes",
            "serverHost": "win93ca",
            "certThumbprint": ["bec0e093d67f32a4d1de065bcb77316c3b255fa9"],
            "hasFileChanged": false
        }]
    }
}

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.
Default1
pageSize optional integer Number of records per page.
Allowed values0 to 512
Default50
filterSelected required string The value to show in the results for each binary that meets the search criteria.
DefaultfileName
Allowed values: algorithm, fileName, filePath, scanName, source, serverHost, isSignedBinaries, fileType, tags, dateSignedOn.
sortedColumnId optional string Sort results by specified parameter.
DefaultfileName
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: sensor, agent.
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 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: 1855828800000
.. .. lastDiscoveredDate integer Date certificate 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.
Default: 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