Joulz

API key and sub code from the Joulz e-Dataportal.

Joulz is a commercial metering service for large consumption connections in the Netherlands.

API key

Joulz checks access with an API key. You create it in the Joulz e-Dataportal, and it belongs to the IP address of the server that collects the metering data: the Meterbeheer server. The correct IP address is below.

You create an API key only once per e-Dataportal, even when Meterbeheer reads several meters with it.

Sub code

Besides the (public) EAN of a connection, Joulz uses a sub code as an extra check. The sub code is unique per connection and is listed with the connection in the e-Dataportal. Look up the sub code of every connection that Meterbeheer should read.

Log in to the e-Dataportal

Step 1. Go to the e-Dataportal through joulz.nl.

The e-Dataportal on joulz.nl

Step 2. Log in.

The e-Dataportal login screen

Create the API key

Step 3. Click the person icon at the top left.

The person icon in the e-Dataportal

Step 4. Click the black gear icon.

The gear icon in the e-Dataportal

Step 5. Enter the IP address of the Meterbeheer server: 116.203.112.240, and click Maak API Key (Create API key).

Enter exactly this IP address. Joulz shows the API key only once: keep it in a safe place.

Look up the sub code

Step 6. Open the Aansluitingen (Connections) page in the e-Dataportal.

The Connections page in the e-Dataportal

Step 7. Click the highlighted icon to show the sub code of a connection.

The icon that shows the sub code

The sub code of a connection

Channels

Electricity

  • consumption: consumption per quarter hour (kWh)
  • production: feed-in per quarter hour (kWh)

Gas

  • consumption: consumption per hour (m3)

Historical data

When you add a meter, Meterbeheer collects over 2.5 years of data, as far as Joulz has it. Is data missing from the feed? Then contact Joulz at klantenservice@joulz.nl.

Error messages

When Meterbeheer cannot collect data, Joulz returns an error message. It is shown in the Meterbeheer dashboard on the meter's page and, with API+, in the feed of the connection as well.