Joulz
API-key en subcode uit het e-Dataportal van Joulz.
Joulz is een commerciële meetdienst voor grootverbruikaansluitingen in Nederland.
API-key
Joulz controleert de toegang met een API-key. Die maak je aan in het e-Dataportal van Joulz, en die hoort bij het IP-adres van de server die de meetdata ophaalt: de server van Meterbeheer. Het juiste IP-adres staat hieronder.
Per e-Dataportal maak je maar één keer een API-key aan, ook als Meterbeheer er meerdere meters mee uitleest.
Subcode
Naast het (openbare) EAN van een aansluiting gebruikt Joulz een subcode als extra controle. De subcode is uniek per aansluiting en staat in het e-Dataportal bij de aansluiting. Zoek voor elke aansluiting die Meterbeheer moet uitlezen de subcode op.
Inloggen op het e-Dataportal
Stap 1. Ga naar het e-Dataportal via joulz.nl.

Stap 2. Log in.

De API-key aanmaken
Stap 3. Klik linksboven op het persoonicoon.

Stap 4. Klik op het zwarte tandwiel.

Stap 5. Vul het IP-adres van de server van Meterbeheer in: 116.203.112.240, en klik op Maak API Key.
Vul precies dit IP-adres in. Joulz toont de API-key maar één keer: bewaar hem op een veilige plek.
De subcode opzoeken
Stap 6. Open de pagina Aansluitingen in het e-Dataportal.

Stap 7. Klik op het gemarkeerde icoon om de subcode van een aansluiting te tonen.
![]()

Channels
Elektriciteit
- consumption: verbruik per kwartier (kWh)
- production: teruglevering per kwartier (kWh)
Gas
- consumption: verbruik per uur (m3)
Historische data
Bij het toevoegen haalt Meterbeheer de data van ruim 2,5 jaar terug op, voor zover Joulz die heeft. Ontbreekt er data in de feed? Neem dan contact op met Joulz via klantenservice@joulz.nl.
Foutmeldingen
Kan Meterbeheer geen data ophalen, dan geeft Joulz een foutmelding. Die staat in het dashboard van Meterbeheer op de pagina van de meter, en met API+ ook in de feed van de aansluiting.