GET
/api/me/audit-logAuthenticatedList 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_logAccountAuthentication & permissionsAuthenticated
Any authenticated user
- Accepted credentials
- Auth server session (refresh token cookie)
cookie "refresh_token_<auth_server_app_id>" - Access token (cookie)
cookie "access_token_<auth_server_app_id>" - Access token (Bearer)
Authorization: Bearer <JWT>
- Auth server session (refresh token cookie)
- Who may call
- Any authenticated user
Query parameters
| Name | Type | Description |
|---|---|---|
| limit | integer | Page size (default 25, at most 100). |
| cursor | string |
|
| 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
| Property | Type | Description |
|---|---|---|
| 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 |
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>'