API referenceEvents
GET /events
Query Parameters
since?string
Window start (RFC3339); defaults to 24h before until
until?string
Window end (RFC3339); defaults to now
limit?integer
Max events to return (default 50, max 500)
Format
int64appId?string
Filter by app
channelId?string
Filter by channel
environmentId?string
Filter by environment
eventType?string
Filter by event type
source?string
Filter by source
status?string
Filter by status
traceId?string
Filter by trace id
agentId?string
Filter by agent id
agentName?string
Filter by agent name
toolName?string
Filter by tool name
semanticKind?string
Filter by semantic kind (agent, tool, llm, retriever, db, http, log)
serviceName?string
Filter by service (resource service.name)
operationName?string
Filter by operation / span name
errorType?string
Filter by error type
q?string
Case-insensitive contains match on search text
attrKey?string
JSONB attribute key for equality filter (paired with attrValue)
attrValue?string
JSONB attribute value for equality filter (paired with attrKey)
Response Body
application/json
application/problem+json
curl -X GET "https://example.com/events"{ "$schema": "https://example.com/schemas/SearchEventsOutputBody.json", "events": [ { "agentId": "string", "agentName": "string", "appId": "string", "attributes": null, "cacheReadTokens": 0, "cacheWriteTokens": 0, "channelId": "string", "costSource": "string", "costUsd": 0.1, "createdAt": "string", "durationMs": 0.1, "environmentId": "string", "errorMessage": "string", "errorType": "string", "eventId": "string", "eventType": "string", "finishReason": "string", "inputTokens": 0, "metadata": null, "occurredAt": "string", "operationName": "string", "orgId": "string", "outputTokens": 0, "parentSpanId": "string", "payload": null, "payloadSpilled": true, "providerName": "string", "reasoningTokens": 0, "requestModel": "string", "resourceAttributes": null, "responseModel": "string", "semanticKind": "string", "serviceName": "string", "sessionId": "string", "source": "string", "spanId": "string", "status": "string", "toolName": "string", "totalTokens": 0, "traceId": "string", "ttftMs": 0.1, "userId": "string" } ]}