System Log

The System Log records system events that are related to your organization in order to provide an audit trail that can be used to understand platform activity and to diagnose problems.

The System Log API provides near real-time, read-only access to your organization's system log and is the programmatic counterpart of the System Log UI.

The terms "event" and "log event" are often used interchangeably. In the context of this API, an "event" is an occurrence of interest within the system, and a "log" or "log event" is the recorded fact.

The System Log API supports these primary use cases:

  • Event data export into a security information and event management system (SIEM)
  • System monitoring
  • Development debugging
  • Event introspection and audit

The System Log API isn't intended for use as a Database as a Service (DBaaS) or to serve data directly to downstream consumers without an intermediate data store.

See Events API Migration for information on migrating from the Events API to the System Log API.

List all System Log Events
CORS
OAuth 2.0: okta.logs.read

Lists all system log events. The Okta System Log API provides read access to your organization’s system log. This API provides more functionality than the Events API

Request
query Parameters
since
string <date-time>
until
string <date-time>
filter
string
q
string
limit
integer
Default: 100
sortOrder
string
Default: "ASCENDING"
after
string
Responses
200

Success

403

Forbidden

429

Too Many Requests

get/api/v1/logs
Request samples 
Response samples 
application/json
[
  • {
    • "actor": {
      },
    • "authenticationContext": {
      },
    • "client": {
      },
    • "debugContext": {
      },
    • "displayMessage": "string",
    • "eventType": "string",
    • "legacyEventType": "string",
    • "outcome": {
      },
    • "published": "2019-08-24T14:15:22Z",
    • "request": {
      },
    • "securityContext": {
      },
    • "severity": "DEBUG",
    • "target": [
      ],
    • "transaction": {
      },
    • "uuid": "string",
    • "version": "string"
    }
]