My Devices API

Access & limitsAPI key needed · Light▾

This API answers with your own account data, so it needs your API key. Send it in an X-API-Key header, or as api_key= in the address. The limits below are the with-key ones.

	5 minutes	Hour	Day
Without a key	30	300	2,000
With a key	150	1,500	10,000

Log in to create a free key on your profile page.

Every answer carries X-RateLimit-Remaining and X-RateLimit-Reset. Over a limit, the answer is error 429 with retry_after in seconds. Refused requests do not count.

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

Parameter	Meaning
type	Optional. all (the default), altimetercloud for our own hardware, or thirdparty for third party altimeters.
mac	Optional. The serial of one of your devices, to get just that one.

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

Code	Meaning
401	No key was sent (key_required), or the key is not recognised (invalid_key)
403	The key is not allowed from this address or country
412	type= is not one of the three
429	Past a limit; retry_after says how long to wait