Get Switch Scenes

The API returns the virtual switch details and scene information. A virtual switch is added to the floor plan in the Enlighted Manage (EM) when a Switch Group is created. A virtual switch controls the light levels of selected fixtures. Each set of light level settings for fixtures is called a scene.

For example, in a conference room, typical scenes would include

  • using a projector when the lights should be off (all off), or
  • during a meeting when the lights should be on (all on).  


GET https://{em_ip_address_or_hostname}/ems/api/org/switch/v1/getSwitchScenes/{floor_id}/{switch_name}


em_ip_address or hostname The EM’s IP address or hostname.
floor_id Floor identifier. Returned in Get All Floors API, or in EM, select Facility > Floor > in the left panel, and click the Settings tab to obtain the floor_id.
switch_name Switch name. Returned in Get Switch Groups API, or in EM, select Facility > Floor in the left panel, click Floor Plan tab, and hover the cursor over the switch icon to see the switch name. 
id Switch Identifier to which the scene belongs.
name Switch name.

List of scenes. A maximum of six scenes can be created for a switch. For each scene, the following parameters are displayed.

  • id** - Scene identifier (**used as the primary identifier in other API calls).
  • switchid - Switch identifier to which the scene belongs.
  • name - Scene name.
  • sceneOrder - Order of scenes on the associated Enlighted Room Control (ERC) switch.

Sample Code

Using the switch name (SwitchGrp2) returned in the Get Switch Groups and Floor ID returned in Get All Floors, request the Manage to provide the virtual switch and scene details. For example, if the switch, SwitchGrp2, is configured for two scenes All on, All off, the following virtual switch details are returned as shown below. The scene identifiers (for example, 157, 158) returned for the scenes are used as the primary identifiers in other API calls.


HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/json
Content-Length: 7582
Date: Sat, 21 Jul 2015 17:06:51 GMT

  "id":"7",             **switch identifier**
  "name":"SwitchGrp2", **switch name**
      "id":"157",        **scene identifier (Primary id used in other API calls)**
      "switchid":"7",  **switch identifier (Primary id used in other API calls)**
      "name":"All On", **scene name**
      "sceneOrder":"1" **scene order**
      "id":"158",        **scene identifier**
      "switchid":"7",  **switch identifier**
      "name":"All Off", **scene name**
      "sceneOrder":"2" **scene order**


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Article is closed for comments.