Get Audit Logs

Retrieves audit logs for the account.

📘

This API is exclusive to Enterprise Shield accounts

📘

To view a complete list of audit log event types and their schema, see Audit Log Events

To view a complete list of actor and target types, see Actors and Targets

📘

This endpoint is paginated. For more information, see Pagination .


Valid Authentication Methods

OAuth 2.0 User Token and Account Token Scopes:

  • account.audit.logs

Query Params
date-time

The timestamp from which the audit logs will be returned. Defaults to 14 days prior to the "to" parameter if it is defined, otherwise 14 days prior to the current timestamp.

date-time

The timestamp to which the logs will be returned. Defaults to the current timestamp.

integer
Defaults to 200

The number of audit logs to return per request.

string

A token used for pagination to retrieve the next page of results when polling audit logs.

Headers
string
required
Defaults to 1

The API version used in the request.

Responses

400

Bad request. Occurs when the query parameters are invalid.

403

Forbidden. Occurs when the authorized token does not have permission to access audit logs.

Language
Credentials
OAuth2