Sign in

v1

latestOpenAPI 3.1.02026-08-042453938.9 KB
Events

List events with payloads (flat format)

Returns events joined with their stored payloads in a flat, tabular format designed for data engineers and SQL-based workflows.

Each row is a single event with its input/output payloads inlined. Only events that have stored payloads are returned (i.e., events created with input or output fields).

Filters: customerId, actionName, from/to (ISO 8601 date range), hasInput, hasOutput (boolean).

Use cases:

  • Export to data warehouses (BigQuery, Snowflake, Redshift)
  • Ad-hoc SQL analysis of event payloads
  • Training data extraction for ML pipelines
  • Compliance audits requiring full payload history
get/v1/events/payloads

Query parameters

customerIdstring

Filter by customer

actionNamestring

Filter by action name

eventType'USAGE' | 'API_CALL' | 'LLM_INFERENCE' | 'TOOL_CALL' | 'DATABASE' | 'FILE_IO' | 'NETWORK' | 'DECISION' | 'HUMAN_IN_LOOP' | 'MEMORY' | 'CUSTOM' | 'TOOL_CALL_START' | 'TOOL_CALL_END' | 'TOOL_CALL_ERROR' | 'TOOL_CALL_RETRY' | 'TRAINING' | 'FINE_TUNING'

Filter by event type

fromstring date-time

Start of time range (inclusive)

tostring date-time

End of time range (inclusive)

hasInputboolean

Only events with input payloads

hasOutputboolean

Only events with output payloads

limitinteger
offsetinteger

Response

Flat list of events with inlined payloads

sql_hintstring

Example SQL query for this data set