---
title: "Stream incoming events"
method: GET
path: "/api/stream/event"
tags: ["Board", "Bot"]
---

# Stream incoming events

`GET /api/stream/event`

Stream the events reaching a lichess user in real time as [ndjson](#description/streaming-with-nd-json).

An empty line is sent every 7 seconds for keep alive purposes.

Each non-empty line is a JSON object containing a `type` field. Possible values are:
- `gameStart` Start of a game
- `gameFinish` Completion of a game
- `challenge` A player sends you a challenge or you challenge someone
- `challengeCanceled` A player cancels their challenge to you
- `challengeDeclined` The opponent declines your challenge

When the stream opens, all current challenges and games are sent.

Only one global event stream can be active at a time. When the stream opens, the previous one with the same access token is closed.

## Response `200`

The stream of events reaching the logged in user.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)