Slash
Team inbox

List employees with email impersonation statistics

Retrieves a paginated list of employees whose identity has been used in email impersonation attacks in the workspace. For each employee, returns detailed information including their identification data and a breakdown of email impersonation attacks:

  • total number of attacks impersonating the employee;
  • number of attacks confirmed as fraudulent;
  • number of attacks pending review;
  • number of attacks confirmed as safe.

Scopes required:

  • inbox:read
get/v1/slash/employees/impersonation_statistics

Request

  • Base URL: https://public-api.tryriot.com
  • URL: https://public-api.tryriot.com/v1/slash/employees/impersonation_statistics
  • Auth: API key in header x-api-key

Query parameters

cursorstring

Pagination cursor for retrieving the next page of results. This value is obtained from the 'x-next-cursor' response header of a previous API call. The cursor should be passed unchanged to fetch next pages. See https://docs.tryriot.com/api-reference/introduction#pagination for examples.

limitinteger

Maximum number of items to return. Maximum value is 100.

workspace_idstring uuid required

ID of the workspace

created_afterstring date-time required

Filter records created after this date (included)

created_beforestring date-time required

Filter records created before this date (included)

Headers

x-item-limitinteger

Maximum number of items to return. Maximum value is 100.

x-next-cursorstring

Pagination cursor for retrieving the next page of results. This value is obtained from the 'x-next-cursor' response header of a previous API call. The cursor should be passed unchanged to fetch next pages. See https://docs.tryriot.com/api-reference/introduction#pagination for examples.

Response

Employees with email impersonation stats

Example response

{
  "data": [
    {
      "employee": {
        "name": "John Doe",
        "primary_email_address": "john.doe@tryriot.com"
      }
    }
  ]
}

Changes

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