“Cozifythlon 2026” HAN RestAPI competition
We invite you to experiment and develop!
Are you interested in monitoring your home's electricity consumption in real time, building your own automations, or developing new ways to utilize energy data? The open RestAPI interface of the Cozify HAN device makes this possible! Now we invite all enthusiasts – especially slightly more advanced home users and DIY enthusiasts – to try out what you can do with the HAN device interface.
Participate in the Cozifythlon 2026 competition – the best ways to utilize RestAPI will be rewarded! Send your ideas to challenge@cozify.fi no later than March 1, 2026.
What is Cozify HAN RestAPI?
Cozify HAN is a Finnish electricity consumption and production reading device designed for Nordic conditions, which is connected directly to the HAN port of the electricity meter. The device has a built-in HTTP server (port 80), through which the RestAPI interface provides access to the meter's real-time readings - in phases, watts, amps, volts and much more.
Cozify HAN RestAPI is free of charge for consumer customers.
What can you do with the RestAPI interface?
Real-time electricity consumption monitoring: Get meter readings directly from the device and visualize consumption data in your own app or even in Home Assistant.
Building automation: Control home devices based on electricity consumption, production, or even the price of electricity on the exchange.
Developing your own user interface: Create a view of energy consumption that suits you – the possibilities are endless!
Examples of usage
Home Assistant integration: With Cozify HAN's RestAPI interface, you can import electricity consumption data directly into your Home Assistant system and utilize it in automations.
Custom dashboards and alerts: Create your own alerts when consumption exceeds a certain limit, or monitor the yield of your solar panels in real time.
Competition and community: Participate in the Cozifythlon 2026 competition – the best ways to utilize RestAPI will be rewarded! Send your ideas to challenge@cozify.fi no later than March 1, 2026.
How do you get started?
Get a Cozify HAN device and connect it to the HAN port of your electricity meter
Open a browser and try: http://COZIFY-HAN-OSOITE/meter – you will get a JSON-formatted meter reading directly from the device.
OpenAPI - Brief description
|
Explanations of the response fields:
type: Message type identifier
- ts: Timestamp in milliseconds (Unix epoch)
- ic: Active cumulative power imported (kWh)
- ec: Active cumulative power exported (kWh)
- ric: Reactive cumulative power imported (kVArh)
- rec: Reactive cumulative power exported (kVArh)
- p: Array of active power values (W) [Total, Phase 1, Phase 2, Phase 3]
- pi: Array of active power consumption values W [Total, Phase 1, Phase 2, Phase 3]
- pe: Array of active power overproduction values W [Total, Phase 1, Phase 2, Phase 3]
- r: Array of reactive power values (VAr) [Total, Phase 1, Phase 2, Phase 3]
- u: Array of voltage readings (V) [Phase 1, Phase 2, Phase 3]
- i: Array of current readings (A) [Phase 1, Phase 2, Phase 3]
Why is it worth trying?
- Openness and extensibility: RestAPI enables unlimited development and integration.
- Community support: Cozify encourages sharing ideas and implementations – the best ones are rewarded!
- Finnish product, for Finnish homes: Designed and manufactured in Finland, tested together with electricity grid companies.
Get inspired, experiment and develop! Get the most out of your Cozify HAN device and share your experiences with others. Participate in the competition, subscribe to the newsletter and stay up to date with the development. Ask more, share your ideas and register: challenge@cozify.fi
Sources and more information:
- Cozify HAN Home Assistant example
- Cozify HAN user manual and support
- Cozify HAN product page
- Cozify HAN and Shelly
Thank you for reading! Share your experiences and feedback at challenge@cozify.fi
Jukka Talja
Cozify, Head of Sales