Skip to main content

Filter codesigning certificates

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

Use this endpoint to get the list of codesigning certificates 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":"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

Allowed values: scanName, status, thumbprint, source, org, ca, serialNumber, filePath, serverHost, tags.

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.

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

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