Explore Plans
Mobile menu Close menu
Philips HuePhilips Hue

Get Lights

This query returns all lights of the bridge.

Developer info

API endpoint slug
hue.get_lights
Runtime method
performQuery("hue.get_lights")

Query fields

No fields for this query

Ingredients

IDLight Id

Slug
light_id
Filter code
Hue.getLights.Id
Type
String
Example
1

NameA unique, editable name given to the light.

Slug
name
Filter code
Hue.getLights.Name
Type
String
Example
Kitchen Light

StatusRunning status of the light (on/off)

Slug
status
Filter code
Hue.getLights.Status
Type
String
Example
off

ReachableDescribes if the light is available to the bridge at the moment.

Slug
reachable
Filter code
Hue.getLights.Reachable
Type
String
Example
true

BrightnessA value between 1 and 254 indicating the brightness of the light.

Slug
brightness
Filter code
Hue.getLights.Brightness
Type
String
Example
20

EffectThe dynamic effect of the light, can either be "none" or "colorloop".

Slug
effect
Filter code
Hue.getLights.Effect
Type
String
Example
colorloop

HueHue of the light. This is a wrapping value between 0 and 65535.

Slug
light_hue
Filter code
Hue.getLights.Hue
Type
String
Example
152

SaturationSaturation of the light. 254 is the most saturated (colored) and 0 is the least saturated (white).

Slug
saturation
Filter code
Hue.getLights.Saturation
Type
String
Example
200

Color temperatureThe Mired Color temperature of the light. 2012 connected lights are capable of 153 (6500K) to 500 (2000K).

Slug
color_temperature
Filter code
Hue.getLights.ColorTemperature
Type
String
Example
2044

XyThe comma separated x and y coordinates of a color in CIE color space.

Slug
cie_xy
Filter code
Hue.getLights.Xy
Type
String
Example
0.409,0.5179

ColormodeIndicates the color mode in which the light is working. "hs" for Hue and Saturation, "xy" for XY and "ct" for Color Temperature.

Slug
colormode
Filter code
Hue.getLights.Colormode
Type
String
Example
hs