System integrator API

What is the System integrator API?

You can use the System Integrator API to connect smart solutions to your Niko Home Control installation. Designed for professionals and system integrators, this API is available under licence.

Niko or your professional installer do not support applications or solutions you build with the System integrator API. For support, Niko refers to the communities listed above.

What can you do with Niko Home Control?

By using Niko Home Control with the System integrator API, you can do the following:

Retrieve your available Niko Home Control locations
Retrieve your available Niko Home Control actions and devices
Control your Niko Home Control actions and devices
Receive status information from your Niko Home Control actions and devices
Receive notification messages from your Niko Home Control installation

You can find the API documentation here.

What do you need?

	In short	Extra information
General	No additional electrical wiring is required. You have a computer with a web browser and an internet connection. You have knowledge of MQTT and JSON. You are a professional and want to use the API in commercial applications.
	Your Niko Home Control system meets the following requirements: It has a wireless smart hub or a connected controller II. It is configured with the most recent programming software (version 2.17 or higher). It has an active internet connection.
	The API is on your connected controller or wireless smart hub. You have your JWT API access token.	If you have no token, request it via https://www.niko.eu/en/our-products/home-automation/api-for-system-integrators/api-access-request . You need to sign a licence agreement first before you will receive the token. The access token is perpetual and does not need to be renewed.

In short

Extra information

General

No additional electrical wiring is required.
You have a computer with a web browser and an internet connection.
You have knowledge of MQTT and JSON.
You are a professional and want to use the API in commercial applications.

Your Niko Home Control system meets the following requirements:

It has a wireless smart hub or a connected controller II.
It is configured with the most recent programming software (version 2.17 or higher).
It has an active internet connection.

The API is on your connected controller or wireless smart hub.
You have your JWT API access token.

If you have no token, request it via https://www.niko.eu/en/our-products/home-automation/api-for-system-integrators/api-access-request .

You need to sign a licence agreement first before you will receive the token.

The access token is perpetual and does not need to be renewed.

How do you set up the connection?

Once you have signed the licence agreement and received your token, you can access the API on the connected controller or wireless hub without any additional steps.