Metering API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/metering-points/{metering_point_id}/readings
X-Api-Key<token>

In: header

Path Parameters

metering_point_idstring

Kennung der Messstelle

Query Parameters

from?string

Filter: interval_start >= diesem Wert (ISO 8601, UTC)

Formatdate-time
to?string

Filter: interval_start < diesem Wert (ISO 8601, UTC)

Formatdate-time
direction?string

Nach Richtung des Energieflusses filtern

Value in"production" | "consumption"
quality?string

Nach Datenqualität filtern

Value in"uploaded" | "forecast" | "estimated"
limit?integer

Höchstzahl der Einträge pro Seite

Default10
Range1 <= value <= 100
after?string

Cursor 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"
}