GET/api/me/audit-logAuthenticated

List my audit log

Lists the security-relevant events of the caller's account, newest first: sign-ins (and failed attempts), password resets, MFA changes, applications they authorized, what administrators did to the account, and what the caller did in their organizations. Paginated with cursor. ip_address and user_agent are returned for the caller's own requests and for failed sign-ins to their account, never for another user's request.

operationId get_api_me_audit_logAccount

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials
Who may call
Any authenticated user

Query parameters

NameTypeDescription
limitinteger

Page size (default 25, at most 100).

cursorstring

next_cursor of the previous page: lists the events older than that page.

event_type"user.registered" | "user.signed_in" | "user.sign_in_failed" | "user.mfa_challenge_failed" | "user.signed_out" | "user.password_reset" | "user.email_verified" | "user.profile_updated" | "user.mfa_factor_added" | "user.mfa_factor_removed" | "user.mfa_recovery_codes_regenerated" | "user.mfa_reset_by_admin" | "user.app_authorized" | "user.app_authorization_revoked" | "user.app_scope_consent_revoked" | "user.device_authorized" | "user.device_authorization_denied" | "user.disabled" | "user.enabled" | "user.promoted_to_admin" | "organization.created" | "organization.deleted" | "organization.invitation_sent" | "organization.invitation_revoked" | "organization.invitation_accepted" | "organization.invitation_declined" | "organization.member_added" | "organization.member_role_changed" | "organization.member_removed" | "organization.mfa_requirement_enabled" | "organization.mfa_requirement_updated" | "organization.mfa_requirement_disabled"

Only list events of this type.

Responses

application/json
ListAuditLogResponse
PropertyTypeDescription
success*true
data*object
entries*AuditLogEntry[]
audit_event_id*string
created_at*number
event_type*"user.registered" | "user.signed_in" | "user.sign_in_failed" | "user.mfa_challenge_failed" | "user.signed_out" | "user.password_reset" | "user.email_verified" | "user.profile_updated" | "user.mfa_factor_added" | "user.mfa_factor_removed" | "user.mfa_recovery_codes_regenerated" | "user.mfa_reset_by_admin" | "user.app_authorized" | "user.app_authorization_revoked" | "user.app_scope_consent_revoked" | "user.device_authorized" | "user.device_authorization_denied" | "user.disabled" | "user.enabled" | "user.promoted_to_admin" | "organization.created" | "organization.deleted" | "organization.invitation_sent" | "organization.invitation_revoked" | "organization.invitation_accepted" | "organization.invitation_declined" | "organization.member_added" | "organization.member_role_changed" | "organization.member_removed" | "organization.mfa_requirement_enabled" | "organization.mfa_requirement_updated" | "organization.mfa_requirement_disabled"
actor*object | null | null
uid*string | null | null
email*string | null | null
subject*object | null | null
uid*string | null | null
email*string | null | null
organization_id*string | null | null
client_app_id*string | null | null
ip_address*string | null | null
user_agent*string | null | null
details*object | null | null
next_cursor*string | null | null

Pass as cursor to get the next (older) page; null on the last page.

JSONExample
"success"true
"data"
"entries"
"next_cursor""string"

Example request

bashcurl
curl -X GET 'https://auth.botreeinc.com/api/me/audit-log' \
  -b 'refresh_token_<auth_server_app_id>=<value>'