Skip to main content
GET
List security events

Authorizations

x-access-token
string
header
required

Organization API token. Generate from Organization Settings → API Tokens.

Query Parameters

cursor
string

next_cursor from the previous page. Store it after each page and send it back unchanged; it remembers your filters, so repeat the same filters with it.

Maximum string length: 2048
since
string<date-time>

Where to start when you have no cursor. Defaults to 24 hours ago. Ignored when cursor is sent.

limit
integer
default:500

Events per page.

Required range: 1 <= x <= 1000
outcome
enum<string>

Only successful or only failed events.

Available options:
success,
failure

Response

One page of events, oldest first.

data
object[]
required
next_cursor
string
required

Send this as cursor on the next call. On an empty page it is the cursor you sent, so a caught-up poller keeps it and waits.

has_more
boolean
required

true when more events are ready now — fetch again immediately. false means wait before polling.