Events API reference

Durable event journal, replay cursors and live WebSocket delivery

REST journal

GET /v1/events returns a cursor page. GET /v1/events/{event_id} returns one eligible immutable event.

WebSocket stream

Connect to /v1/events/stream with an API key or a single-use browser ticket from POST /v1/events/stream-ticket. Subscribe with country, family, event-type and cursor filters.

Recovery

Persist the last acknowledged cursor. Reconnect with it to replay the gap before live delivery resumes. Expired cursors, slow consumers and revoked rights close with an explicit error and resume cursor.