Security Logs

List User Security Logs

Required scopes: security-log (Read only).

get/users/{userId}/security-logs

Request

Path parameters

userIdinteger required

User Identifier. Get via Get Authenticated User for own security logs or via List Users (available only for enterprise organization admins and owner)

Query parameters

limitinteger

A maximum number of items to retrieve

offsetinteger

A starting offset in the collection

event'login' | 'password.set' | 'password.change' | 'email.change' | 'login.change' | 'personal_token.issued' | 'personal_token.revoked' | 'mfa.enabled' | 'mfa.disabled' | 'session.revoke' | 'session.revoke_all' | 'sso.connect' | 'sso.disconnect' | 'user.registered' | 'user.remove' | 'application.connected' | 'application.disconnected' | 'webauthn.created' | 'webauthn.deleted' | 'trusted_device.remove' | 'trusted_device.remove_all' | 'device_verification.enabled' | 'device_verification.disabled' | 'user.force_removed' | 'user.blocked' | 'user.unblocked' | 'team.member.added' | 'team.member.removed' | 'role.admin.granted' | 'role.admin.revoked' | 'role.group_manager.granted' | 'role.group_manager.revoked' | 'organization.settings.saml.changed' | 'organization.settings.invite_restrict.changed' | 'organization.settings.device_verification.changed' | 'organization.settings.mfa.changed' | 'organization.settings.remember_me.changed' | 'organization.settings.sign_up.changed' | 'organization.settings.token_creation.changed' | 'organization.settings.token_expiration.changed' | 'sso.custom_app.configured' | 'sso.custom_app.disabled' | 'organization.auth_method.disabled' | 'organization.auth_method.enabled'
Example:login
createdAfterstring

Date in UTC, ISO 8601

createdBeforestring

Date in UTC, ISO 8601

ipAddressstring

Response

User Security Logs list

Example response

{
  "data": [
    {
      "data": {
        "id": 2,
        "event": "Some event",
        "info": "Some info",
        "userId": 4,
        "location": "USA",
        "ipAddress": "127.0.0.1",
        "deviceName": "MacOs on MacBook",
        "createdAt": "2019-09-19T15:10:43+00:00"
      }
    }
  ],
  "pagination": {
    "limit": 25
  }
}

Changes

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