Skip to main content

List audit logs

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

Use this endpoint to get a list with details about your Discovery audit logs.

Example requests and responses

Request parameters

Name

Reqd/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":"function",
    "operation":"EQUALS",
    "value":["Abort scan"]
  }
]

divisionIds

required

array

User's division ID.

startIndex

optional

integer

Start at the specified index.

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

string

Sort results by specified parameter.

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

Default: createdDate

sortOrder

optional

string

Sort direction.

Allowed values: ASC (ascending: 0-9, A-Z), DESC (descending: 9-0, Z-A)

Default: DESC

Request parameters

Name

Type

Description

error

object

Includes error codes, if any.

data

object

Object with details about the filter results.

.. totalCount

integer

Total number of keys based on the filter criteria.

.. currentCount

integer

Number of records on current page.

.. auditLogs

array

Container for audit logs detail.

.. id

integer

ID associated with the audit log.

.. ..userId

integer

User ID of the person who performed the action.

… userName

string

Name of the user who performed the action.

… divisionId

integer

User’s division ID.

… divisionName

string

User’s division name.

… module

string

Module for which the audit log is generated.

… function

string

Functional action for which the audit log is generated.

… message

string

Action message sent for the audit log.

… detailMessage

string

Detailed message with additional information about the request.

… ipAddress

string

IP address of the user’s system or network from where the action was performed.

… ipCountry

string

Country from where the action is performed.

… createdDate

integer

Date when the audit log was created.

Filter options for searchCriteriaList

Key

Operation

Value

userName

EQUALS

username

dateRange

EQUALS

dateFrom-string, dateTo-string

function

EQUALS

User action performed

ipAddress

EQUALS

User IP address

divisionName

EQUALS

division name