Available nowIn progressLast updated: June 2026

Events API

The Events API lists accepted operational events. It is used to inspect activity by event type, source, timestamp, and result limit.

Endpoint

GET /v1/events

Filtering

Filter by event type, source, timestamp range, and result limit.

Explorer UX

Richer Event Explorer views and advanced query paths are in progress.

Example request

GET /v1/events?event=payment.failed&source_id=src_123&limit=50

Query parameters

Use query parameters to narrow event results without changing the endpoint path.

Parameter	Example	Description
event	payment.failed	Filter events by event type.
source_id	src_123	Filter events by the source that produced them.
from_ts	2026-06-01T00:00:00Z	Return events created at or after this timestamp.
to_ts	2026-06-01T23:59:59Z	Return events created before or at this timestamp.
limit	50	Limit the number of returned events.

Example response

The exact response shape should stay synchronized with the backend OpenAPI specification as the API stabilizes.

{
  "items": [
    {
      "id": "evt_123",
      "event_id": "evt_demo_001",
      "event_type": "payment.failed",
      "source_id": "src_123",
      "environment": "production",
      "severity": "critical",
      "created_at": "2026-06-01T10:00:00Z",
      "payload": {
        "amount": 49.99,
        "currency": "EUR",
        "reason": "card_declined"
      }
    }
  ],
  "limit": 50,
  "next_cursor": null
}

Investigate incidents

Filter by source, event type, and time range to understand what happened during an operational issue.

Trace source activity

Review events produced by a specific app, backend, ERP connector, worker, or integration.

Verify ingestion

Confirm that accepted events are visible after being sent through the Ingestion API.

Build operational views

Use event records as the foundation for dashboards, timelines, alerts, and future replay workflows.

Prefer time-window queries when investigating incidents. This keeps results focused and makes event timelines easier to review.

The Events API is available in the developer preview, but richer Event Explorer UX, advanced filtering, pagination hardening, and replay-oriented views are still in progress.