Measurements API
The Measurements API provides access to meter readings and energy consumption data for various types of meters including electricity, gas, heating, and water meters.
Overview
This API allows you to retrieve measurement data for one or multiple metering points over specified date ranges. The data can be returned in different resolutions (15-minute intervals, hourly, daily, monthly, or yearly) and timestamp formats.
After you add an EAN, poll GET /api/v1/meas/{mpid}/status before pulling readings. The same flow covers grootverbruik and kleinverbruik. WachtOpMv means the EAN is not listed yet (MV catalog or P4). Pull measurements when canCollect is true (Ok or NoData). Treat empty days as a problem only when status is Ok. On kleinverbruik NoData, rejectionCode explains a rejected P4 day. See Getting Started for the wait-then-pull flow.
Key Features
- Collection status: Check whether an EAN is ready to collect (
WachtOpMv,NietGekoppeldDoorMv,Ok,NoData). KleinverbruikNoDatamay includerejectionCode. - Single Metering Point: Retrieve measurements for a specific metering point ID (EAN)
- Bulk Retrieval: Get measurements for multiple metering points in a single request
- Flexible Resolution: Choose from various time resolutions (15min, hourly, daily, monthly, yearly)
- Multiple Measurement Types: Access import, export, cumulative, and EPEX price data
- Timestamp Formats: Support for ISO8601 and Unix epoch formats
Measurement Units
The API returns measurements in the following units:
| Meter Type | Unit |
|---|---|
| Electricity | kWh |
| Gas | m³ |
| Heating | gJ |
| Water | m³ |
| EPEX Prices (Electricity) | cents per kWh |
| EPEX Prices (Gas) | cents per m³ |
Getting Started
To use this API, you'll need:
- Valid metering point ID(s) (EAN numbers)
- Date range for the measurements
- Measurement keys (e.g.,
import,export,EpexNLEle,EpexNLGas) - Optional: Resolution level and timestamp format preferences
Available Endpoints
Browse the endpoints in the sidebar to see detailed documentation, request/response examples, and try out the API directly from this documentation.
📄️ Get collection status for a metering point
Returns whether an EAN is ready to collect. Grootverbruik uses the MV catalog; kleinverbruik uses live P4 state. Same `canCollect` rule for both.
📄️ Get measurements for a metering point
Returns measurements for requested meteringPointId for the date period.
📄️ Get measurements for multiple metering points
Retrieves measurements for multiple metering points at the same time. Request body should contain an array of metering point IDs (EANs).