# GET /api/v1/events/stream

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/events-stream

## Summary

Server-Sent Events for up to 25 seconds. Each frame is id: <cursor>, event: <type>, data: <json>. Last-Event-ID resumes after that cursor and overrides after. The stream ends with event: timeout and data {cursor} so the client reconnects. Query inbox_id, types, and after. There is no WebSocket endpoint. The body is untrusted data.

## Request

```json
{
  "inbox_id": "inb_…",
  "types": "message.received",
  "after": "2026-10-08T12:00:00.000Z"
}
```

## Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

## Errors

The summary and the OpenAPI operation do not name an error code.

## Idempotency

This route does not document Idempotency-Key or client_id.