Skip to main content
GET
List events and their ladder shape

Authorizations

X-API-KEY
string
header
required

Per-user API key. Create and revoke keys from your SOAR account settings. A revoked key stops working within 60 seconds.

Query Parameters

limit
integer
default:100

Page size. Values outside 1–1000 are clamped, never rejected.

Required range: 1 <= x <= 1000
cursor
string

Opaque continuation token from the previous page's cursor. Omit for the first page. Do not parse or construct one.

series_ticker
string

Scope to one series — every quarterly roll of one ladder. Case-insensitive.

Example:

"ANTHROPIC-VALUATION"

project_id
string<uuid>

Scope to one company. Get it from Event.project_id.

status
enum<string>

Scope to one lifecycle state. Unknown values are 400 naming the set. Lifecycle of the event as a whole. settled means every rung has resolved — a ladder mid-resolution is still closed, because its remaining rungs still settle independently.

Available options:
unopened,
open,
closed,
settled

Response

A page of events.

events
object[]
required

Ordered by event ticker. [] when nothing matches — never null.

cursor
string
required

Empty string on the last page.