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
| Parameter | Type | Description |
|---|---|---|
device_id | integer | device 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
| Code | Cause |
|---|---|
| 400 | Invalid device_id format |
| 404 | Device not found or not owned by customer |