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.

cURL

curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/certificates/codesigning/filter' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw 
'{
    "accountId": 5153184,
    "searchCriteriaList": [{
        "key": "status",
        "operation": "EQUALS",
        "value": ["VALID"]
    }],
    "divisionIds": [],
    "startIndex": 1,
    "pageSize": 50,
    "filterSelected": "scanName",
    "sortedColumnId": "thumbprint",
    "sortOrder": "ASC"
}'

200 OK

{
    "error": null,
    "data": {
        "filterName": "scanName",
        "displayName": "Scan name",
        "values": ["AgentscanX", "box64", "crypto", "helloarch", "hhhh", "linuxcore2s20all", "m80winone", "scan0418s10", "scan37linuxnocapi", "scan999", "win93one"]
    }
}

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.
.. certificates	array	List of items that meet the search criteria. The value shown is the value set for the `filterSelected` parameter in the request body.

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`

Request parameters

Response parameters

Filter options for searchCriteriaList

About