GET /v2/devices

Returns all devices belonging to the authenticated customer.

Request

curl -k https://api.illumience.com:11443/v2/devices \
  -H "Authorization: Bearer <api_key>"

Response 200 OK

{
  "total": 2,
  "devices": [
    {
      "device_id": 4521,
      "mac": "AABBCCDDEEFF",
      "active_status": "active",
      "nickname": "Site Alpha",
      "lat": -33.918,
      "long": 18.423,
      "sw_version": "1.2.3",
      "cl_version": "4.5.6"
    },
    {
      "device_id": 4522,
      "mac": "112233445566",
      "active_status": "inactive",
      "nickname": "Site Bravo",
      "lat": null,
      "long": null,
      "sw_version": null,
      "cl_version": null
    }
  ]
}

Response Fields

Field	Type	Description
total	integer	Number of devices returned
devices	array	List of device objects

Device Object:

Field	Type	Description
device_id	integer	Unique numeric device identifier
mac	string	Device MAC address (no separators)
active_status	string	Current status (e.g. "active", "inactive")
nickname	string	User-assigned device name
lat	float	Latitude of installed location
long	float	Longitude of installed location
sw_version	string	Foundation software version
cl_version	string	Cleon software version

All device fields except device_id may be null.