Overview

The audit trail events method allows you to track and investigate actions that your employees perform in the Sumsub Dashboard. It can be used to monitor team activity, ensure compliance, and detect suspicious operations. This method is particularly useful when you need a detailed activity log for a specific employee, for example, during internal reviews or regulatory audits.

You can access audit trail data in the following ways:

• API request — supports the complete set of event types, covering activities such as logins, applicant management actions, data downloads, exports, and more. You can filter results by employee, action type, and time range using Query Params when making a request. To understand how to interpret the API response, refer to the Response explained section.
• Dashboard — provides access to a limited activity log on the Team → Activity log page, showing team and permission management actions, such as creating or updating accounts, changing roles, and so on. You can filter results by date range and action type directly on the page. All other event types can only be provided through the API request.

🚧

Attention

This feature is available at an additional cost. Contact us to learn more.

📘

Note

• Events are always sorted by ts in a descending order.
• The maximum number of events per request is 20000.

Response explained

The HTTP status 200 in the response confirms the availability of our API:

Event types