Event

API to fetch device events.

Get Events.

get

Long poll or stream device event data.

Authorizations

HueApplicationKey

hue-application-keystringRequired

Header parameters

If-None-MatchstringOptional

Unix timestamp of the last seen event, followed by :0.

If any events in the server's buffer have a timestamp greater than this, the server will send them immediately instead of blocking for new events. The server does not maintain a persistent buffer and purges old events after several minutes and does not indicate when the value of If-None-Match falls outside of its buffered window, so clients must poll consistently often else events will be silently missed.

Example: 1770336203:0

Responses

200

Events Success Response

application/jsontext/event-stream

idstringRequired

A UUID that identifies this batch of events.

Example: 4bc4c418-e0d1-434d-aeca-b8e8bd39032bPattern: ^[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}$

typestring · enumRequiredPossible values:

creationtimestring · date-timeRequired

Time of creation for this batch of events.

Example: 2026-02-05T19:33:06Z

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

405

Method Not Allowed

application/json

406

Not Acceptable

application/json

409

Conflict

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Service Unavailable

application/json

507

Insufficient Storage

application/json

get

/eventstream/clip/v2

HTTPcURLJavaScriptPython

GET /eventstream/clip/v2 HTTP/1.1
Host: 192.168.1.0
hue-application-key: YOUR_API_KEY
Accept: */*

[
  {
    "creationtime": "2026-02-05T20:04:15Z",
    "id": "7c1d96be-cf0d-4c3c-8f13-08df14b3966b",
    "type": "update",
    "data": [
      {
        "id": "40252235-b3e6-488c-b981-495a1755c5f9",
        "id_v1": "/lights/22",
        "on": {
          "on": false
        },
        "owner": {
          "rid": "8eae78ef-be2d-4b67-b6cf-ad027b147914",
          "rtype": "device"
        },
        "service_id": 0,
        "type": "light"
      },
      {
        "id": "639d878e-add1-4dca-89d5-a141ce4bd10b",
        "id_v1": "/lights/12",
        "on": {
          "on": false
        },
        "owner": {
          "rid": "c6328005-e4dd-4470-8b4d-5408f393d4a6",
          "rtype": "device"
        },
        "service_id": 0,
        "type": "light"
      },
      {
        "id": "de4a6334-d168-4016-8681-97cdd7751f36",
        "id_v1": "/lights/8",
        "on": {
          "on": false
        },
        "owner": {
          "rid": "1cf4070c-53dd-4cf0-8518-eb3e0da63a86",
          "rtype": "device"
        },
        "service_id": 0,
        "type": "light"
      },
      {
        "id": "725e6c00-50d4-40f5-8214-3a97f2e25c72",
        "id_v1": "/lights/19",
        "on": {
          "on": false
        },
        "owner": {
          "rid": "5b8a4967-0339-487e-a66d-92c21d5d72c4",
          "rtype": "device"
        },
        "service_id": 0,
        "type": "light"
      }
    ]
  }
]