REST API

Events

Events are the raw observations captured by your application. They are ingested asynchronously through the Ingestion Service and stored for querying and analysis.

GET/events

Query events for the authenticated organization. Supports filtering by project, type, severity, correlation ID, and time range.

Auth:JWT Session (cookie)

Query Parameters

Name	Type	Required	Description
`project_id`	string	optional	Filter events to a specific project.
`type`	string	optional	Filter by event type (e.g. manual, server_error, webhook).
`severity`	"info" \| "warn" \| "error" \| "critical"	optional	Filter by severity level.
`correlation_id`	string	optional	Filter events sharing a correlation ID.
`from`	ISO 8601 string	optional	Return events after this timestamp.
`to`	ISO 8601 string	optional	Return events before this timestamp.
`limit`	number	optional	Maximum number of events to return. Defaults to 50, max 500.

GET /events?project_id=proj_01HX...&severity=error&limit=20 HTTP/1.1

HTTP/1.1 200 OK

[
  {
    "id": "evt_01HX...",
    "type": "server_error",
    "severity": "error",
    "source": "api-service",
    "message": "Unhandled exception in /api/checkout",
    "payload": {
      "status_code": 500,
      "path": "/api/checkout",
      "method": "POST"
    },
    "correlationId": "order_9988",
    "projectId": "proj_01HX...",
    "organizationId": "org_01HX...",
    "capturedAt": "2026-03-12T18:45:32.000Z"
  }
]