Skip to main content

Filter binaries

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

Use this endpoint to get a list of binaries based on the filter criteria selected.

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":"isSignedBinaries",
    "operation":"EQUALS",
    "value":["Yes"]
  }
]

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

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

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.

.. filterName

string

Specified filter key.

.. displayName

string

Name of the filter key as it appears in the UI.

.. values

array

List of items that meet the search criteria.

The value shown is the value set for the filterSelected parameter in the request body.

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