My Devices API

The devices on your own account: every Altimeter Cloud altimeter and screen, and the third party altimeters you have added, with whether each is online, its firmware and hardware, whether a firmware update or a settings change is waiting, and its latest flight. It needs your API key, and it only ever answers with the devices of the account that owns the key.

Parameters

Send your key in an X-API-Key header. api_key= in the address works too, but a header keeps it out of server logs.

The answer

{
  "success": true,
  "type": "all",
  "count": 2,
  "online": 1,
  "devices": [
    {
      "serial": "1051-DBEC-747C",
      "source": "altimetercloud",
      "kind": "altimeter",
      "model": "mercuryv1",
      "tag": "Club rocket",
      "firmware": "2.41",
      "latest_firmware": "2.42",
      "update_available": true,
      "hardware": "3",
      "online": true,
      "last_seen": "2026-10-01T09:12:44Z",
      "settings_waiting": false,
      "battery_pct": 87,
      "wifi": { "network": "Field", "rssi_dbm": -61 },
      "flights": 42,
      "last_flight": { "id": 12345, "apogee_m": 312.4, "uploaded": "..." }
    }
  ]
}

online is true when the device has been in touch in the last few seconds. Third party altimeters never connect to the cloud, so theirs is null. settings_waiting is true when a settings change saved on the website has not yet been picked up by the device. Wi-Fi passwords and other settings are never included.

Errors