Skip to main content

Filter audit logs

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

Use this endpoint to get a list of the filter values based on the filter selected. This endpoint is helpful when you wish to filter out the discovery audit logs based on filter criteria available.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

accountId

required

string

Account ID.

searchCriteriaList

optional

array

Filter results by specified values. For definitions, see the Filter options for searchCriteriaList table below.

Example:

searchCriteriaList:[
  {
    "key":"userName",
    "operation":"EQUALS",
    "value":["CertCentral Admin"]
  }
]

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.

Default: 50

Allowed values: 0 to 512

filterSelected

required

string

The value to show in the results for each sensor that meets the search criteria.

Allowed values: userName, dateRange, function ipAddress, divisionName

sortedColumnId

optional

string

Sort results by specified parameter.

Allowed values: createdDate, userName, ipAddress, divisionName, ipCountry

Default: createdDate

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

Friendly name of the filter key as it appears in the UI.

..values

array

List of sensors that meet the search criteria. The value shown for each sensor 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

userName

EQUALS

Username

dateRange

EQUALS

dateTo-string, dateFrom-string

function

EQUALS

User action performed

ipAddress

EQUALS

User IP address

divisionName

EQUALS

division name