In this guide

List Light Level Sensors

Current light level sensors and their v2 resource IDs.

Action referenceRead

What this action does #

First, connect Philips Hue in Services. Then open Actions → + → Philips Hue and choose List Light Level Sensors.

Inputs to fill in #

This action has no input fields. You can name and save it after choosing the action.

What comes back #

In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.

Returned fieldTypeMeaning
errorsarrayA list of values.
errors[].descriptionstringText value.
errors[].error_codestringText value.
dataarrayA list of values.
data[].idstringText value.
data[].id_v1stringText value.
data[].typestringText value.
data[].ownerobjectA group of named values.
data[].owner.ridstringText value.
data[].owner.rtypestringText value.
data[].metadataobjectA group of named values.
data[].metadata.namestringText value.
data[].metadata.archetypestringText value.
data[].servicesarrayA list of values.
data[].services[].ridstringText value.
data[].services[].rtypestringText value.
data[].enabledbooleanTrue or false.
data[].lightobjectA group of named values.
data[].light.light_levelintegerLegacy logarithmic light level.
data[].light.light_level_validbooleanTrue or false.
data[].light.light_level_reportobjectA group of named values.
data[].light.light_level_report.changedstringText value.
data[].light.light_level_report.light_levelinteger10000 × log10(lux) + 1; this is not a raw lux value.

Run it from Shortcuts #

  1. Give the action a recognizable name and tap Save.
  2. In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
  3. Supply any Param or File slots you bound in the inputs, then run the shortcut.

If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.

Advanced reference #

Request, permissions, and identifiers

Request: GET https://api.meethue.com/route/clip/v2/resource/light_level

Action identifier: philips-hue.light_level.list.v1

No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.

Philips Hue API reference