The Basic API is part of Meterbeheer’s standard services. Master data and fault codes for low-volume connections are displayed in the dashboard.
With the API+ subscription, this data is also available via the API. The data is included in the JSON file for each individual connection.
API+ subscription – Stem data and fault codes #
In the base API, the following master data is included in the JSON URL:
- EAN
- Channel
- Unit (kWh or m³)
- Start period
- End period
With an API+ subscription, the following information is added to the JSON URL:
- Connection type (residential or commercial)
- Utility provider
- Date the current meter was installed
- Mandate start date (equal to the availability of historical data)
- Mandate end date
Fault codes EDSN #
If an EDSN connection does not receive measurement data, the EDSN gives a fault code. The code is displayed in the Meterbeheer dashboard. If the API+ subscription is activated, the failure code is also displayed in the JSON URL at the relevant data interval.
| Error codes from the EDSN | Description | Action by | Explanation |
| 006 | The EAN connection is unknown. | Customer | The correct combination of EAN, ZIP code, and house number must be entered. |
| 007 | No smart meter present on EAN connection. | Owner connection | Request smart meter from the network operator. |
| 008 | The requesting party is not authorized. | Customer | Add the mandate for this EAN with the appropriate date. |
| 009 | No meter data available. The smart meter is in the deployment phase. | Connection owner / utility | The smart meter needed to be activated by the grid operator. |
| 010 | The date for the requested dates is in the future. | Client | Adjust the date for the request. |
| 011 | The date range you requested is too old. Meter readings are no longer available. | Customer | Please adjust the date of the request. |
| 012 | Requested metering data not available, meter temporarily out of service | Grid operator | The grid operator should clear the fault. |
| 013 | This particular request cannot be fulfilled by the meter. | Customer | Modify instructions. |
| 014 | Requested metering data not available: fault is known and in process. | Grid operator | The grid operator should clear the fault. |
| 038 | Smart meter is administratively off. | Connection owner | The owner of the connection must give permission to the grid operator to read the measurement data remotely. |
| 039 | There is a technically non-remote smart meter attached | Owner connection | The smart meter needs to be replaced. |
| 040 | The requesting party is not mandated (anymore) because the authorization was terminated following a change of contractor on the connection. | Customer | There is a new contracting party so the meter needs to be removed and re-registered. |
| 041 | Requested metering data not available: large-scale failure. | Grid operator | Grid operator should correct the fault. |