Airthings Hub implementation

Hi, was wondering if somebody has a solution to implement an Airthings Hub
or if someone already has found a way to connect to the Airthings API via OpenHAB.
Unfortunately the binding supports only Bluetooth which is no option in my infrastructure.

There are some Bluetooth bindings for OH. If the device only supports Bluetooth you would need something that uses Bluetooth. Since that is not an option for you, this is not a good solution to meet your requirements.

Hi Bruce,
The Sensor-Devices are Bluetooth only.
But the Hub is supposed to be implemented in Homeautomation. It’s connected via LAN and via API to the Airthings Cloud.

I don’t know thou, if the Manufacturer API is meant to be implemented.

HI all,

I just purchased an AirThings package as well. I am using 2 x Wave Plus’s, 2 x Wave Minis and a Hub. I too am very interested in trying to get this setup as well.


I asked Airthings about getting access to their API as a private person, but the answer was no.
They say a bit more about it here: Integrations: API

We can only hope that they will open up for it soon, as it was one of their original selling points for the hub.


I did a little bit of research and found, that the Airthings Dashboard uses a simple RESt API. I would now like to write a binding to access this API from OpenHAB. As there is an existing Airthings Binding, I’m now wondering, if it would be wise to implement a new binding, or extend the already existing binding.

Maybe the original maintainers of the binding (@Kai and @pauli_anttila) could join the discussion. What would you think?

Best regards


I think I would go for a separate binding, since the existing one is just an extension of the Bluetooth binding and coupled to that. And users that want to use the cloud api clearly have no interest in the bluetooth code on their installation. I’d suggest to go for airthingscloud as a binding id.

@stefanvogl & @nza: Feel free to mention to Airthings that you want to do the integration on behalf of the openHAB project - maybe this counts a bit more than “being a private person”, who knows!

I was wandering around the account today and it looks like there’s an API available for non-business customers: Getting Started with the Airthings API | Airthings

The documentation is at API Docs | Airthings and I was able to generate a token.

Hallo Kai,
probably it could make sense to bring different posts regarding airthings together? I also try since months… Here is Kris’ post who succeeded without any API issue:

It looks like it works easy. I ended up in the request of a PIN (Pairing mode)
Would also be happy to get any help or if I can help to find a solution.

Hi Stefan,

I’m still trying to figure out how to implement a solution utilizing the AirThings Hub and/or cloud services. Did you ever find a way to get this working? I installed Home Assistant just to see if I could get Airthings to work there and it does flawlessly. From there, I thought I’d be able to figure out how to make it work in OpenHAB but I guess I am not smart enough! Any help would be appreciated.


unfortunately I didn’t have time to even start with implementing this. The Airthings API seems pretty straight forward. You have to log-in (using openid-connect) and get a token. With this token you can authenticate to the API. There you have devices with measurements. That’s basically it.

As I haven’t developed any OpenHAB addons, the setting up the boilerplate and everything, kept me from starting in the first place. So, if anyone (preferrably someone with some addon experience) would set this up, I’d be more than happy and willing to help and contribute.

1 Like

Thanks for responding. I think I am getting somewhere. I use Node-Red as my rules engine and since it is always running, I decided to give that a crack. I created a flow and sub-flow which work well to grab the sensor data from the cloud and push it to my mqtt broker. I know need to figure out how to get the mqtt data into OpenHAB. I’ve gotten as far as setting up a “Generic MQTT Thing” but am getting tripped up on how to set the channel and corresponding item to read the sensor data.

1 Like

Hi Pete,
would you share how you managed to get this done using NodeRed? I am not a coder and would really love to get airthings hub (api) data into my openhab environment.

Hi Stefan,
your post is a bit older now. Did you get forward with your idea of creating an API based binding in addition to the existing BLE binding?

Thanks and best regards

Hi, no, I didn’t have the time to do it. I wrote a python script, that queries the sensors and sends it to an MQTT broker. That works for me at the moment. Of course, a binding would be the more convenient way.

If you like, I can share the script. Nothing fancy (and can be improved of course).

Best regards