GET /v1/metering-points/{metering_point_id}/readings
Die Messwerte einer Messstelle in einem Zeitfenster auflisten, aufsteigend nach interval_start sortiert. Alle Zeitstempel sind ISO 8601 in UTC; die Werte sind Dezimalzahlen in kWh. Erforderlicher Scope: metering:read
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Messstelle
Query Parameters
Filter: interval_start >= diesem Wert (ISO 8601, UTC)
date-timeFilter: interval_start < diesem Wert (ISO 8601, UTC)
date-timeNach Richtung des Energieflusses filtern
"production" | "consumption"Nach Datenqualität filtern
"uploaded" | "forecast" | "estimated"Höchstzahl der Einträge pro Seite
101 <= value <= 100Cursor für die nächste Seite — den Wert next_cursor aus der vorherigen Antwort übergeben
Response Body
curl -X GET "https://api.otark.com/v1/metering-points/mp_e4f8a2c6/readings?from=2026-03-18T12%3A00%3A00Z&to=2026-03-18T13%3A00%3A00Z&direction=production&quality=uploaded&limit=10&after=mp_a1b2c3d4"{
"readings": [
{
"interval_start": "2026-03-18T12:00:00Z",
"interval_end": "2026-03-18T12:15:00Z",
"value": 4356.742,
"direction": "production",
"quality": "uploaded"
},
{
"interval_start": "2026-03-18T12:15:00Z",
"interval_end": "2026-03-18T12:30:00Z",
"value": 4102.31,
"direction": "production",
"quality": "uploaded"
},
{
"interval_start": "2026-03-18T12:30:00Z",
"interval_end": "2026-03-18T12:45:00Z",
"value": 3541.955,
"direction": "production",
"quality": "uploaded"
},
{
"interval_start": "2026-03-18T12:45:00Z",
"interval_end": "2026-03-18T13:00:00Z",
"value": 4001.118,
"direction": "production",
"quality": "uploaded"
}
],
"pagination": {
"limit": 10,
"has_more": false,
"next_cursor": null
}
}{
"type": "https://api.otark.com/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/metering-points/mp_e4f8a2c6/readings",
"errors": [
{
"field": "readings.2.interval_start",
"code": "not_quarter_hour",
"message": "interval_start must be on a quarter-hour boundary (UTC), received '2026-03-18T12:07:00Z'"
}
]
}{
"type": "https://api.otark.com/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: metering:write. Please create a new API key with the required scopes."
}{
"type": "https://api.otark.com/errors/metering_point_not_found",
"title": "Messstelle nicht gefunden",
"status": 404,
"instance": "/v1/metering-points/mp_e4f8a2c6"
}/metering-points/{metering_point_id}/readings POST
15-Minuten-Messwerte einer Messstelle in einer einzigen Anfrage hochladen. Die Zeitstempel sind ISO 8601 in UTC und müssen auf einer Viertelstundengrenze liegen; die Werte sind Dezimalzahlen in kWh. Ein Messwert, der ein bereits vorhandenes Intervall in derselben Richtung trifft, überschreibt den gespeicherten Wert. Der Stapel wird als Ganzes verarbeitet — scheitert ein Messwert an der Validierung, wird nichts geschrieben, und die Antwort führt die Feldfehler auf. Über die API hochgeladene Messwerte sind Daten des Teilnehmers und dienen der Anzeige, dem Vergleich und der Planung. Sie ersetzen nicht die Lieferung des Messstellenbetreibers an OES, und granulare Zertifikate entstehen aus ihnen nicht. Erforderlicher Scope: metering:write
/metering-points/{metering_point_id}/imports POST
Eine CSV-Datei mit Messwerten für eine Messstelle hochladen. Das Dateiformat — Spalten, zulässige Einheiten und Wertregeln eingeschlossen — folgt der Spezifikation der Lastgangdateien: semikolongetrennt, mit Kopfzeile, ein 15-Minuten-Intervall je Zeile, eine Messstelle je Datei. Die Verarbeitung läuft asynchron — die Antwort liefert den Import im Status pending; das Ergebnis fragen Sie über den Endpunkt zum Importstatus ab. Eine Datei wird vollständig importiert oder gar nicht. Erforderlicher Scope: metering:write