Illumience API

GET /v2/devices/{device_id}

Returns a single device. Only devices belonging to the authenticated customer are accessible.

Request

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

Path Parameters

ParameterTypeDescription
device_idintegerdevice identifier, can be found by calling /v2/devices

Response 200 OK

Returns a single device object with the same fields as the device list endpoint.

{
  "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"
}

Errors

CodeCause
400Invalid device_id format
404Device not found or not owned by customer