DIdigicert
Audit logs

List audit logs using cursor pagination

Use this endpoint to list the audit logs for your account using cursor-based pagination.

This endpoint provides more efficient pagination for large datasets compared to offset-based pagination.

Pagination Flow:

  1. First page request: Make a request without cursor_timestamp and cursor_id parameters

    GET /api/v1/audit-log/cursor?account_id={account_id}&limit=10

  2. Subsequent page requests: Use the next_cursor_timestamp and next_cursor_id values from the previous response's pagination object

    GET /api/v1/audit-log/cursor?account_id={account_id}&limit=10&cursor_timestamp=2026-06-07T04:25:42.722&cursor_id=84d8b98f-c1a6-4232-9944-dbfc135aced9

The response includes a pagination object with has_next to indicate if more records are available, and next_cursor_timestamp/next_cursor_id for fetching the next page.

get/api/v1/audit-log/cursor

Request

Query parameters

cursor_timestampstring date-time

Cursor timestamp from the previous page response (ISO-8601 format).

Not required for the first page - only include this parameter when fetching subsequent pages using the next_cursor_timestamp value from the previous response's pagination object.

cursor_idstring

Cursor ID from the previous page response.

Not required for the first page - only include this parameter when fetching subsequent pages using the next_cursor_id value from the previous response's pagination object.

limitinteger

Number of records to fetch per page (default is 50)

direction'NEXT' | 'PREVIOUS'

Direction of pagination - NEXT (default) or PREVIOUS

sort_by'timestamp'

Sort field name (only "timestamp" is supported)

sort_order'ASC' | 'DESC'

Sort order - ASC or DESC (default is DESC)

idstring
action'SIGN' | 'UPDATE' | 'ENABLE' | 'DISABLE' | 'CREATE' | 'DELETE' | 'EMAIL_SENT' | 'FETCH' | 'AUTHORIZE' | 'SEND_OTP' | 'REVOKE' | 'VERIFY' | 'LIST'
resource_type'VALIDATION' | 'SIGNATURE' | 'LICENSE' | 'CREDENTIAL' | 'TIMESTAMP' | 'MANAGER_CONFIG' | 'DSE_ACCOUNT' | 'DSE_PROFILE' | 'CERTIFICATE_PROFILE' | 'SIGNING_PROVIDER' | 'DOCUMENT' | 'CERTIFICATE' | 'SELF_ENROLLMENT_LINK' | 'VALIDATION_PROFILE' | 'DSM_CERTIFICATE_TEMPLATE' | 'DSM_CERTIFICATE_PROFILE' | 'MIGRATION' | 'PRODUCT' | 'ONBOARDING' | 'SIGNER' | 'USER'
resource_idstring
account_idstring
user_idstring
start_datestring date-time

Start date in ISO 8601 format

end_datestring date-time

End date in ISO 8601 format

status'SUCCESS' | 'FAILURE'
created_bystring
certificate_typeCredentialProfileCertType[]
certificate_levelCertificateProfileType[]

Response

Audit logs list with cursor pagination

Example response

{
  "pagination": {
    "count": 50,
    "limit": 50,
    "has_next": true,
    "next_cursor_timestamp": "2025-11-27T10:30:00",
    "next_cursor_id": "12345678-1234-1234-1234-123456789012",
    "previous_cursor_timestamp": "2025-11-27T11:00:00",
    "previous_cursor_id": "98765432-1234-1234-1234-123456789012"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.