Skip to content

Device Metadata

These routes provide access to device metadata management within the user’s account. They allow users to retrieve metadata for all devices or a specific device identified by its EUI, including information such as device status, identification, configuration, connectivity, location, and ownership details. The update endpoint allows users to modify device metadata, including labels, device settings, network information, firmware details, and associated tags.

GET /user/device/meta/all

This route retrieves the metadata for all devices associated with the user’s account, including details such as device label, type, EUI, battery, temperature, firmware, signal, location, and ownership information.

  • Example response:
{
  "errors": [],
  "debug": [],
  "meta": [],
  "data": [
    {
      "uid": 2710,
      "device_ref": 2710,
      "ts_activity_first_unix": null,
      "ts_activity_last_unix": null,
      "battery_percent": 100,
      "battery_voltage": null,
      "temperature_dc": 15.8,
      "installation_lat": null,
      "installation_lon": null,
      "ts_data_first_unix": 1645182203,
      "ts_data_last_unix": 1645624908,
      "lat": null,
      "lon": null,
      "alt": null,
      "firmware_version": null,
      "signal_percent": null,
      "signal_dbm": null,
      "devEUI": "5A9F1B7D2C8E4F31",
      "decoder_ref": 1,
      "type": "LoRaWAN",
      "type_ref": 1,
      "icon_ref": null,
      "network_ref": null,
      "owner_ref": null,
      "id": 620,
      "username": "coper",
      "user_ref": 826,
      "label": "Helium_l4_wardriving",
      "folder": null,
      "tags": null
    },
    {
      "uid": 2788,
      "device_ref": 2788,
      "ts_activity_first_unix": null,
      "ts_activity_last_unix": null,
      "battery_percent": 50,
      "battery_voltage": null,
      "temperature_dc": null,
      "installation_lat": null,
      "installation_lon": null,
      "ts_data_first_unix": 1645046050,
      "ts_data_last_unix": 1645115962,
      "lat": null,
      "lon": null,
      "alt": null,
      "firmware_version": null,
      "signal_percent": null,
      "signal_dbm": null,
      "devEUI": "8C3D2A9F4B7E1D60",
      "decoder_ref": 1,
      "type": "LoRaWAN",
      "type_ref": 1,
      "icon_ref": null,
      "network_ref": null,
      "owner_ref": null,
      "id": 621,
      "username": "coper",
      "user_ref": 826,
      "label": "Helium_TTI_iU800B",
      "folder": null,
      "tags": null
    }
  ],
  "success": true
}

GET /user/device/meta/{eui}

This route retrieves the metadata for a specific device identified by its EUI, including details such as user/owner references, location, battery and signal status, firmware, device type, label, and tags.

  • Example response:
{
  "errors": [],
  "debug": [],
  "meta": [],
  "data": [
    {
      "uid": 29907,
      "device_ref": 29907,
      "ts_activity_first_unix": null,
      "ts_activity_last_unix": 1705869299,
      "battery_percent": null,
      "battery_voltage": null,
      "temperature_dc": null,
      "installation_lat": null,
      "installation_lon": null,
      "ts_data_first_unix": 1704900906,
      "ts_data_last_unix": 1705865699,
      "lat": null,
      "lon": null,
      "alt": null,
      "firmware_version": null,
      "signal_percent": null,
      "signal_dbm": null,
      "devEUI": "5A9F1B7D2C8E4F31",
      "decoder_ref": 1,
      "type": "LoRaWAN",
      "type_ref": 1,
      "icon_ref": null,
      "network_ref": 1,
      "owner_ref": null,
      "id": 2325,
      "username": "coper",
      "user_ref": 826,
      "label": "Jeff.UK MapQuester-v1-001",
      "folder": null,
      "tags": null
    }
  ],
  "success": true
}

POST /user/device/meta/{eui}

This route allows updating a device’s metadata, including label, user/owner references, location, battery, temperature, signal, firmware, type, decoder, network, icon, and tags.