Skip to main content
The audit_logs client methods are currently in BETA. The API may change without notice. A one-time warning is emitted on first use.
Retrieve audit log entries for your account. The caller must be an account admin and the account must have audit logging enabled — otherwise the request returns a 403.

Key Capabilities

  • List audit log entries newest-first with cursor-based pagination
  • Filter by time window (start_time / end_time)
  • Filter by user (user_id)
  • Filter by operation type (QUERY, MUTATION, or SUBSCRIPTION)

List Audit Logs

List audit log entries with optional filtering. When start_time and end_time are omitted, the server defaults to the last 30 days.
For details on pagination, field introspection, and data conversion (to dict/JSON/DataFrame), see Response Objects.

Operation Types