API ReferenceSub devices
Read one sub-device
AuthorizationBearer <token>
A session token for an existing account, obtained from POST /auth/login (see the Authentication endpoints) - not an API key. Endpoints marked with this scheme reject API key callers outright, regardless of what that key is granted. Outside the Authentication endpoints themselves, everything requiring this scheme manages dashboard resources (rules, grants, keys, device configuration, command catalogs) and mirrors what a human does in the Nexalware web app - it is not meant to be automated by a third-party integration the way the Device Control and Schedules endpoints are.
In: header
Path Parameters
deviceId*string
subDeviceId*string
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/devices/dev_a1b2c3/sub-devices/sub_x1y2z3"{ "subDeviceId": "sub_x1y2z3", "externalId": "relay-1", "name": "Garage Light", "state": { "relay": "ON" }, "capabilities": { "commands": [ { "name": "ON" }, { "name": "OFF" } ], "telemetry_metrics": [ "power_draw" ], "verifiable": false }, "verifiable": false, "enabled": true, "isOnline": true, "lastSeen": "2024-11-19T10:05:00.000Z", "createdAt": "2024-11-01T09:00:00.000Z"}