get https://{url}/v1/devices/
Use the hub_url received in the registration response as your base URL.
This API requires the device to authenticate, see Device Authentication.
Get device information from the server.
Return Data
| Name | Type | Description | |
|---|---|---|---|
| id | string | Unique ID for this device | |
| partner | object | Partner-provided details: | |
| model | string | Device model | |
| vendor | string | Manufacturer name | |
| sn | string | Device's serial number | |
| mac | string | Device's MAC address | |
| cloud_id | string | Device's Cloud ID, if set | |
| config | object | Latest server configuration for this device: | |
| version | number | Current configuration version | |
| last_updated | datetime | Configuration update timestamp | |
| state | object | Latest device state, according to telemetry | |
| details | object | Custom device details set via Update Device API | |
| custom | object | Optional: Custom info set by drivers | |
| last_seen | datetime | Last time the device sent telemetry | |
| firmware_version | string | Firmware version | |
| latest_firmware | object | Latest available firmware details: | |
| firmware_version | string | Latest available firmware version | |
| firmware_file_id | string | File id for latest available firmware version | |
| name | string | Optional: Device name as set in the UI | |
| claimed | string | Name of the organization this device was claimed by, or NULL |