Submit Measurements
Besides providing data from our integrated metering point operators, you can also submit measurements via our API endpoint /measurements.
Before submitting measurements to our platform, you have to understand the different site types. The site type defines the valid values for the meter field measuring and the required amount of measurings for a successful billing of electricity meters.
For electricity meters, you need to set the meter field direction in correlation with measuring correctly so that its OBIS code is configured correctly.
A heat meter is a meter with medium set to heat and a role (transfer or end_customer) and can be created in unbalanced sites only.
Create it via /v1/meters without direction, grid and measuring: heat meters have none of these fields and the platform rejects them.
Also note that the example timestamps only show HH:mm of the full ISO8601 string.
| Site type site.type | Medium meter.medium | Meter type meter.measuring | Required measurings for billing example timestamps | OBIS Codes |
|---|---|---|---|---|
| Quarter-hourly balanced balanced_accurate | electricity | RLM load_profile_accurate | 96 daily 15:15, 15:30 | 1.29 2.29 |
| electricity | iMSys TAF-7 readings_accurate | 96 daily 15:15, 15:30 | 1.8 2.8 | |
| Monthly balanced balanced_inaccurate | electricity | RLM load_profile_accurate | 96 daily 15:15, 15:30 | 1.29 2.29 |
| electricity | iMSys TAF-7 readings_accurate | 1 daily 00:00 | 1.8 2.8 | |
| electricity | moderne Messeinheit (mME) readings_inaccurate | 1 daily 23:14, 03:22 | 1.8 2.8 | |
| Unbalanced unbalanced_accurate unbalanced_inaccurate | electricity | RLM load_profile_accurate | 96 daily 15:15, 15:30 | 1.29 2.29 |
| electricity | iMSys TAF-7 readings_accurate | 96 daily 15:15, 15:30 | 1.8 2.8 | |
| electricity | moderne Messeinheit (mME) Manual-Read readings_inaccurate | 1 on the key date 00:00 | 1.8 2.8 | |
| heat | Heat meter | 1 on the key date 00:00 | 6-0:1.0.0 |
unbalanced_accurate and unbalanced_inaccurate behave identically: meters of all listed types can be combined in the same site, and reading and billing behavior follows each meter’s measuring (electricity meters) or medium (heat meters), not the site type. Use unbalanced_accurate for new sites. Existing unbalanced_inaccurate sites remain supported.
- You are fully responsible for the correctness and completeness of the measurements.
- The platform does not automatically use interpolation to replace missing measurements. You can do that manually in our web app.
- In order to be able to bill a site, the measurings required by the table above are absolutely necessary.
- Virtual meter measurements cannot be submitted via API, the measurements will be calculated automatically during the balancing process.
- Submitted measurements of type 1.8 and 2.8 must already include the transformer multiplier, if applicable. Our platform is not aware of transformer factors.
- Only measurements corresponding to the specific meter’s measuring type (electricity meters) or medium (heat meters) can be submitted.
- Heat meters accept only measurements of type 6-0:1.0.0, with values in kWh. Convert values in MWh, GJ or MJ to kWh before submitting.
- Electricity meters reject measurements of type 6-0:1.0.0, and heat meters reject every electricity code.