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

idstringUnique ID for this device
partnerobjectPartner-provided details:
modelstringDevice model
vendorstringManufacturer name
snstringDevice's serial number
macstringDevice's MAC address
cloud_idstringDevice's Cloud ID, if set
configobjectLatest server configuration for this device:
versionnumberCurrent configuration version
last_updateddatetimeConfiguration update timestamp
stateobjectLatest device state, according to telemetry
detailsobjectCustom device details set via Update Device API
customobjectOptional: Custom info set by drivers
last_seendatetimeLast time the device sent telemetry
firmware_versionstringFirmware version
latest_firmwareobjectLatest available firmware details:
firmware_versionstringLatest available firmware version
firmware_file_idstringFile id for latest available firmware version
namestringOptional: Device name as set in the UI
claimedstringName of the organization this device was claimed by, or NULL
Click Try It! to start a request and see the response here!