Skip to navigation

List stored events

Newest-first page of this tenant and mode’s events, for support tooling and reconciliation. Keyset pagination: pass back next_cursor until it stops appearing. The cursor is opaque — treat it as a token. Filters are exact-match.

Authentication

AuthorizationBearer

Authorization: Bearer sk_live_… (or sk_test_…). Server-side only — never ship a secret key to a browser or a mobile app. The key determines the tenant and the mode; there is no mode parameter on any request.

Query parameters

limitstringOptional

Page size, 1–100. Default 50.

cursorstringOptional

The next_cursor from the previous page.

event_typestringOptional

Only events of this type (signup, trial_start, trial_convert, checkout_attempt, login).

verdictstringOptional

Only events with this verdict (allow, review, block).

Response

A page of stored events, newest first.
eventslist of objects

The page. Each entry is a StoredEvent, identical to what GET /v1/events/{id} returns.

next_cursorstringOptional
Opaque token for the next page. Absent when this page is the end.

Errors

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error
500
Internal Server Error