List events
Returns event-kind sips sorted by created descending (newest first). With response_type=text, each event is rendered as a flat plain-text digest (field-per-line) instead of a JSON object — same data, fewer tokens for MCPs and AI agents.
query Parameters
idsFetch specific event sips by UUID (RFC 4122), e.g. 339366bc-464d-582f-8132-6875ccc814d2
tagsScalar tag filters (inclusive AND across supplied tags)
qSemantic search query (max 1024 characters; requires embedder)
accMinimum embedding similarity for q (0.0-1.0, higher = stricter)
fromInclude events created on or after this date (YYYY-MM-DD)
response_typeOutput format: json (default) returns a JSON array of flattened digests; text returns the same data as flat plain text without JSON syntax (lower token cost for MCPs and AI agents)
limitPage size
offsetPagination offset
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List events › Responses
JSON array of flattened event digests when response_type=json (default); plain-text event digests when response_type=text
idSip UUID (RFC 4122).
createdCreation timestamp of the sip.
briefingConcise summary of the event.
event_typeCategory or classification of the event.
impact_levelAssessed impact severity.
future_outlookForward-looking assessment of likely developments.
actionsMicro actions or developments that compose the event.
cross_domain_impactsEffects spanning multiple domains or sectors.
peoplePeople mentioned or involved in the event.
regionsGeographic regions associated with the event.
tagsScalar tags for filtering and discovery.